如何正确配置ASP.NET项目的MySQL数据库连接？

环境准备与MySQL驱动安装

1. MySQL数据库安装：确保MySQL服务器已安装并正常运行，创建测试数据库（如TestDB）及表（如Users）。
2. ASP.NET项目创建：通过Visual Studio创建ASP.NET Web Forms、MVC（经典版）或ASP.NET Core项目。
3. MySQL连接驱动安装：
   • 经典ASP.NET（Web Forms/MVC）：通过NuGet安装MySql.Data.Entity包（提供MySQL数据提供程序）。
   • ASP.NET Core：安装MySql.EntityFrameworkCore（EF Core MySQL provider），用于ORM操作。

配置MySQL连接字符串

在项目配置文件（web.config/app.config）的<connectionStrings>节点中添加连接字符串，格式如下：

<connectionStrings>
  <add name="MySqlConnection"
       connectionString="Server=localhost;Database=TestDB;User Id=root;Password=123456;"
       providerName="MySql.Data.MySqlClient" />
</connectionStrings>

• 核心参数说明：
  | 参数 | 说明 | 示例值 |
  |————–|———————–|—————–|
  | Server | MySQL服务器地址 | localhost |
  | Database | 数据库名称 | TestDB |
  | User Id | MySQL用户名 | root |
  | Password | MySQL密码 | 123456 |
  | providerName | 数据提供程序标识 | MySql.Data.MySqlClient |

在ASP.NET项目中使用连接字符串

经典ASP.NET（Web Forms/MVC）

在数据访问层（DAL）创建工具类，通过MySql.Data.MySqlClient连接数据库：

public class MySqlHelper
{
    private static readonly string connString = ConfigurationManager.ConnectionStrings["MySqlConnection"].ConnectionString;
    public static DataTable ExecuteQuery(string sql)
    {
        using (MySqlConnection conn = new MySqlConnection(connString))
        {
            conn.Open();
            MySqlCommand cmd = new MySqlCommand(sql, conn);
            DataTable dt = new DataTable();
            using (MySqlDataAdapter adapter = new MySqlDataAdapter(cmd))
            {
                adapter.Fill(dt);
            }
            return dt;
        }
    }
}

调用示例：var users = MySqlHelper.ExecuteQuery("SELECT * FROM Users");

ASP.NET Core（EF Core）

通过EF Core管理数据库，需在Program.cs或Startup.cs中配置连接字符串和数据库提供程序：

public class MyDbContext : DbContext
{
    public DbSet<User> Users { get; set; }
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseMySql(
            "Server=localhost;Database=TestDB;User Id=root;Password=123456;",
            new MySqlServerVersion(new Version(8, 0, 28)));
    }
}

在控制器中使用：

public class UsersController : Controller
{
    private readonly MyDbContext _context;
    public UsersController(MyDbContext context) => _context = context;
    public async Task<IActionResult> Index()
    {
        var users = await _context.Users.ToListAsync();
        return View(users);
    }
}

常见问题与解决方案

1. 问题：连接失败，提示“无法连接到MySQL服务器”。
   解决：检查MySQL服务是否启动，确认连接字符串中的服务器地址、用户名和密码正确，并确保防火墙未阻止数据库端口（默认3306）。

2. 问题：EF Core初始化时出现“不支持此数据库提供程序”。
   解决：确保已安装MySql.EntityFrameworkCore包，并在OnConfiguring方法中指定正确的MySqlServerVersion（如new Version(8, 0, 28)）。

   

常见问答（FAQs）

1. 问：如何验证MySQL连接字符串是否配置正确？
   答：在ASP.NET项目中，可在控制台页面或调试模式下输出连接字符串（ConfigurationManager.ConnectionStrings["MySqlConnection"].ConnectionString），检查格式和参数是否完整。

2. 问：在ASP.NET Core中配置MySQL数据库需要注意什么？
   答：需安装对应的EF Core MySQL provider（如MySql.EntityFrameworkCore），并在Program.cs中通过UseMySql方法指定服务器版本（避免版本不匹配导致异常）。