MacOS下Python连接Teradata遇字符范围错误求助

我之前帮同事排查过几乎一模一样的问题，这个错误本质是Unicode编码解析异常——U+590048是个超出有效范围的无效码点，大概率是MacOS下Teradata ODBC驱动的字符处理逻辑和Windows不一致导致的，尤其是部分Mac设备的系统编码/语言设置特殊时更容易触发。下面是我亲测有效的几个解决方向：

1. 调整ODBC驱动的编码配置 #

• 打开Mac的「ODBC Administrator」（M系列芯片用户注意用Rosetta打开x86版本的管理工具，Teradata ARM驱动的适配还不够完善）
• 找到你的Teradata DSN配置项，在「高级」或「字符集」标签里，强制设置为UTF-8或ASCII，避免驱动自动检测编码时出现异常映射
• 保存配置后重启Python环境再测试连接

2. 更换适配芯片的ODBC驱动版本 #

• 如果你用的是M系列芯片Mac，别再用x86版本驱动靠Rosetta兼容了，直接去Teradata官网下载官方适配ARM架构的最新ODBC驱动
• 卸载旧驱动后重新安装，再重新配置DSN，很多编码问题都是驱动架构不匹配导致的

3. 在Python代码中强制指定编码 #

尝试初始化连接时显式指定编码参数，绕过驱动的自动检测逻辑：

import teradata
import pyodbc

server='111.00.00.00'
username = 'user'
password = 'pwd'

# 用teradata模块时指定编码
udaExec = teradata.UdaExec(
    appName="test_app",
    version="1.0",
    charset="UTF-8"
)
session = udaExec.connect(method="odbc", system=server, username=username, password=password)

# 或者直接用pyodbc连接时指定编码
conn = pyodbc.connect(
    f"DRIVER={{Teradata}};DBCNAME={server};UID={username};PWD={password};CHARSET=UTF8"
)

4. 调整Mac系统的语言与编码设置 #

• 打开「系统设置」→「通用」→「语言与地区」，把首选语言设为英语或简体中文（避免小众语言的编码映射冲突）
• 进入「高级」选项，勾选「使用Unicode UTF-8提供全球语言支持」（部分Mac版本有这个选项）
• 重启电脑后再测试连接，系统编码的全局设置会影响ODBC驱动的字符处理

5. 尝试SQLAlchemy的Teradata方言连接 #

如果原生teradata模块的问题无法解决，试试SQLAlchemy的Teradata方言，它的编码处理逻辑更成熟：

from sqlalchemy import create_engine

engine = create_engine(f"teradata://{username}:{password}@{server}/?charset=utf8")
conn = engine.connect()

# 执行测试查询验证连接
result = conn.execute("SELECT 1 AS test_col")
print(result.fetchone())
conn.close()

如果以上方法都没用，建议检查出问题的Mac是否安装了第三方编码工具、特殊输入法补丁，这些可能会干扰ODBC驱动的字符解析流程。

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