使用Python pyodbc连接Docker中Sybase数据库的UTF-8编码问题

从你描述的情况来看，这个特殊字符显示异常的问题主要是ODBC驱动与数据库连接时的编码不匹配导致的，Docker的locale配置本身是正确的，但连接字符串缺少编码指定，使得驱动默认用了Latin-1（ISO-8859-1）编码返回数据，而你的环境期望UTF-8。下面是具体的分析和解决方案：

问题根源解析 #

你看到的M\x8adic是Latin-1编码下的字节表示，而正确的Mèdic中è的UTF-8编码是\xc3\xa8。这说明PyODBC从驱动拿到的数据是Latin-1编码的，但你的Python环境（通过PYTHONIOENCODING=utf-8设置）期望UTF-8，所以出现了乱码。

具体解决方案 #

1. 修改PyODBC连接字符串，添加编码参数 #

针对Devart的ODBC驱动，你需要在连接字符串中明确指定字符集，强制驱动以UTF-8返回数据。尝试在connectionString末尾添加;ClientCharset=UTF-8（这是Devart驱动官方推荐的指定客户端字符集的参数）：

connectionString = (
    f'DRIVER={driver};SERVER={server};PORT={port};UID={username};PWD={password};'
    f'DATABASE={db_environment};ClientCharset=UTF-8'
)

如果ClientCharset不生效，可以尝试替换为;CHARSET=UTF-8再测试。

2. 验证Docker容器内的Locale是否生效 #

虽然你已经在Dockerfile中设置了LANG和LC_ALL为ca_ES.UTF-8，但可以进入容器确认配置是否生效：

docker exec -it <your-container-name> locale

输出应该所有项都是ca_ES.UTF-8，如果有异常，可以在Dockerfile的locale-gen步骤后添加update-locale LANG=ca_ES.UTF-8 LC_ALL=ca_ES.UTF-8确保配置生效。

3. 临时测试：手动转换编码（用于确认问题） #

如果暂时无法修改连接字符串，可以尝试手动将返回的字节解码为Latin-1再转成UTF-8，验证是否能得到正确结果：

result = cursor.fetchone()[0]
if isinstance(result, bytes):
    corrected_result = result.decode('ISO-8859-1').encode('utf-8').decode('utf-8')
    print(corrected_result)  # 应该输出'Mèdic'

如果这个方法有效，就进一步确认是驱动返回编码的问题，此时添加连接字符串的编码参数就能彻底解决。

4. 确认数据库字段的字符集 #

确保数据库中对应的CharField字段使用的是UTF-8类的字符集（比如UTF8或UTF8MB4），如果字段本身是Latin-1编码，即使连接端设置了UTF-8，也需要先迁移字段编码。但从你描述的“本该显示'Mèdic'”来看，数据库端应该是正确的，这一步可以作为兜底检查。

总结 #

你的Dockerfile配置（Locale和PYTHONIOENCODING）是正确的，问题出在PyODBC连接时没有指定字符集，导致驱动默认用Latin-1返回数据。添加ClientCharset=UTF-8到连接字符串应该就能解决这个特殊字符乱码的问题。

内容的提问来源于stack exchange，提问作者jordi588