FreeSql 解决 MySQL 5.1.7 latin1 字符集乱码问题

在实际开发中，我们经常会遇到数据库字符集编码问题。本文将详细介绍如何在使用 FreeSql 连接 MySQL 5.1.7 数据库时，正确处理 latin1 字符集编码，避免出现中文乱码问题。

问题背景

当开发者使用 FreeSql 连接 MySQL 5.1.7 版本的数据库时，如果数据库使用 latin1 字符集存储中文数据，查询结果可能会出现类似"阿斯顿"的乱码情况。这种情况通常是由于客户端与服务器端字符集设置不匹配导致的。

解决方案

方案一：使用 MySqlConnector 驱动

FreeSql 提供了两种 MySQL 驱动实现：

1. FreeSql.Provider.MySql（基于官方 MySql.Data）
2. FreeSql.Provider.MySqlConnector（基于 MySqlConnector）

实践证明，使用 MySqlConnector 驱动能更好地处理 latin1 字符集问题：

// 安装 NuGet 包
Install-Package FreeSql.Provider.MySqlConnector

// 配置连接
var fsql = new FreeSqlBuilder()
    .UseConnectionString(DataType.MySql, 
        "Server=192.168.200.131;Port=3306;User ID=game;Password=uu5!^%jg;Database=example_db;Charset=latin1;")
    .Build();

方案二：自定义连接工厂

对于需要更精细控制的情况，可以使用连接工厂方式：

var fsql = new FreeSqlBuilder()
    .UseConnectionFactory(DataType.MySql, () =>
    {
        var conn = new MySqlConnection("连接字符串");
        conn.Open();
        using var cmd = conn.CreateCommand();
        cmd.CommandText = "SET NAMES latin1"; // 显式设置字符集
        cmd.ExecuteNonQuery();
        return conn;
    })
    .Build();

重要注意事项

1. 避免使用 Code First 自动建表：FreeSql 的 Code First 功能默认使用 UTF-8 字符集创建表，可能与现有 latin1 数据库不兼容。

2. 连接字符串配置：确保连接字符串中包含正确的字符集设置，如 Charset=latin1。

3. 驱动选择：MySqlConnector 驱动在字符集处理上通常比官方驱动表现更好，特别是在处理旧版 MySQL 时。

最佳实践

对于生产环境，建议采用以下配置：

services.AddSingleton<IFreeSql>(provider => 
    new FreeSqlBuilder()
        .UseConnectionString(DataType.MySql, Configuration.GetConnectionString("MySql"))
        .UseAutoSyncStructure(false) // 禁用自动同步结构
        .UseMonitorCommand(cmd => Trace.WriteLine(cmd.CommandText)) // 日志记录
        .Build());

通过以上方法，开发者可以有效地解决 FreeSql 连接 MySQL latin1 数据库时的中文乱码问题，确保数据正确显示。