如何在Linux上使用ASP.NET Core访问数据库？

随着.NET Core的跨平台能力日益增强，越来越多的开发者选择在Linux环境下部署ASP.NET Core应用，本文将详细介绍如何在Linux环境中配置ASP.NET Core应用程序，实现对主流数据库（如MySQL、PostgreSQL）的高效访问。

一、准备工作

1、安装.NET SDK：确保已在Linux系统上安装了.NET SDK，可以通过命令行输入wget https://dot.net/v1/dotnet-install.sh下载并安装最新版本的.NET SDK。

2、选择数据库：本文以MySQL为例，但同样的方法适用于PostgreSQL等其他数据库，需提前在Linux上安装好MySQL服务器，并创建所需的数据库及用户。

3、安装数据库连接器：对于MySQL，推荐使用官方的Pomelo.EntityFrameworkCore.MySql库，通过NuGet包管理器安装所需依赖项。

二、创建ASP.NET Core项目

使用命令行工具创建一个新的ASP.NET Core Web API项目：

dotnet new webapi -n LinuxDbApp
cd LinuxDbApp

三、配置数据库连接字符串

在appsettings.json文件中添加或修改ConnectionStrings配置节，指定MySQL数据库的连接字符串：

"ConnectionStrings": {
  "DefaultConnection": "Server=localhost;Database=your_database_name;User=your_username;Password=your_password;"
}

四、安装并配置Entity Framework Core

1、安装EF Core与数据库提供程序：运行以下命令以安装Entity Framework Core及其MySQL提供程序。

dotnet add package Microsoft.EntityFrameworkCore --version 6.0.0
dotnet add package Pomelo.EntityFrameworkCore.MySql --version 6.0.0

2、创建数据模型：定义实体类，例如一个简单的Product类。

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

3、配置DBContext：创建一个继承自DbContext的类，用于与数据库交互。

public class AppDbContext : DbContext
{
    public DbSet<Product> Products { get; set; }
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseMySql(Configuration.GetConnectionString("DefaultConnection"), ServerVersion.AutoDetect(ConnectionString));
    }
}

4、数据库迁移：初始化数据库架构。

dotnet ef migrations add InitialCreate
dotnet ef database update

五、实现数据访问逻辑

在Controller中注入AppDbContext，实现数据的增删改查（CRUD）操作。

[ApiController]
[Route("[controller]")]
public class ProductsController : ControllerBase
{
    private readonly AppDbContext _context;
    public ProductsController(AppDbContext context) => _context = context;
    [HttpGet]
    public async Task<ActionResult<IEnumerable<Product>>> GetProducts() => await _context.Products.ToListAsync();
    // 其他CRUD方法省略...
}

六、部署到Linux服务器

1、发布应用：使用以下命令发布应用到目标目录。

dotnet publish -c Release -o /path/to/publish/directory

2、配置Nginx（可选）：为了提高性能和安全性，可以在Linux服务器上配置Nginx作为反向代理服务器，配置示例如下：

server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

3、启动应用：进入发布目录，运行以下命令启动应用。

dotnet /path/to/publish/directory/LinuxDbApp.dll

至此，你已经成功在Linux环境下部署了一个能够访问MySQL数据库的ASP.NET Core应用，接下来是一些常见问题及解答。

FAQs

Q1: 如何解决连接数据库时的“Authentication with old password”错误？

A1: 确保MySQL服务器配置为支持较新的认证插件，如caching_sha2_password，若问题依旧，尝试在连接字符串中明确指定认证方式，如SslMode=None;Server=localhost;Database=dbname;User=root;Password=password;Convert Zero DateTime=True;Auth=mysql_native_password。

Q2: 在Linux上部署时出现“Unhandled exception. System.IO.IOException: Failed to bind to address /tmp/aspnetcore_overridenfilelock”错误怎么办？

A2: 此错误通常由于文件锁定机制冲突引起，解决方法包括禁用临时文件锁或指定不同的锁定文件路径，在appsettings.json中添加以下配置可禁用文件锁：

"Hosting": {
  "OverrideFileLockBlockCount": 0
}

各位小伙伴们，我刚刚为大家分享了有关“asp.net core linux访问数据库”的知识，希望对你们有所帮助。如果您还有其他相关问题需要解决，欢迎随时提出哦！