XORM连接TiDB需注册mysql驱动、构造含parseTime=True和loc=Local的DSN、设置连接池与DatabaseTZ=time.Local，并关闭字段名自动映射以适配TiDB方言。
在Go项目中用XORM连接TiDB、MySQL或其他兼容MySQL协议的数据库时，必须处理驱动注册、连接参数适配、SQL方言差异和事务行为等关键环节，否则会出现连接失败、时间字段解析错误或批量插入异常。
注册正确的数据库驱动
XORM不自带数据库驱动，需显式导入并注册对应驱动。对TiDB、MySQL 5.7+、MariaDB等，统一使用github.com/go-sql-driver/mysql驱动。
在main.go或初始化文件顶部添加导入语句：import _ "github.com/go-sql-driver/mysql"。这行代码触发驱动init函数注册mysql方言名，XORM后续才能识别mysql作为engine类型。
若跳过此步，调用xorm.NewEngine("mysql", dataSourceName)会报错driver: unknown driver "mysql" (forgotten import?)。
构造兼容TiDB的DSN字符串
方法一：基础参数组合
将用户名、密码、地址、端口、数据库名拼接为标准MySQL DSN格式：user:password@tcp(127.0.0.1:4000)/test?charset=utf8mb4&parseTime=True&loc=Local。
其中4000是TiDB默认端口；parseTime=True必须启用，否则time.Time字段读取为字符串；loc=Local避免时区转换错误——TiDB默认使用系统本地时区，不设此项可能导致时间偏移8小时。
方法二：使用url.QueryEscape处理特殊字符
若密码含@、/、?等符号，直接拼接会导致DSN解析失败。此时应先对用户信息部分做URL编码：user := url.QueryEscape("root")，pass := url.QueryEscape("p@ss/wd")，再组合为user + ":" + pass + "@tcp(...)"。
初始化XORM引擎并启用TiDB特有配置
第一步：创建Engine实例
engine, err := xorm.NewEngine("mysql", dsn)，检查err是否为nil。
第二步：设置连接池与超时
调用engine.SetMaxOpenConns(50)和engine.SetMaxIdleConns(20)，TiDB单节点建议上限设为30～60，过高易触发TiDB端max-open-files限制；engine.SetConnMaxLifetime(30 * time.Minute)可缓解TiDB连接空闲超时自动断开导致的“invalid connection”错误。
第三步：启用TiDB专属优化
执行engine.DatabaseTZ = time.Local，强制XORM使用本地时区解析时间字段；再调用engine.SetColumnMapper(core.SameMapper{})关闭字段名自动下划线转驼峰，因为TiDB表结构通常保持原始命名风格，开启映射反而导致SELECT查不到字段。
第四步：测试连接有效性
运行err = engine.Ping()。若失败，常见原因是TiDB未开启enable-table-lock（非必需），或防火墙阻断4000端口，【务必确认TiDB服务已启动且network telnet通】。
