XORM连接MySQL必须使用格式为“用户名:密码@tcp(地址:端口)/数据库名?参数”的DSN字符串，其中tcp()包裹不可省略，须URL编码特殊字符，并至少包含charset=utf8mb4&parseTime=true&loc=Local参数，且需匿名导入mysql驱动。
要在Go项目中用XORM框架成功连接MySQL，DSN（Data Source Name）字符串必须严格符合格式要求，缺一不可，否则会卡在invalid connection或Ping() timeout错误上。
DSN基础结构与必需字段
MySQL的XORM DSN必须是单个字符串，格式为：用户名:密码@tcp(地址:端口)/数据库名?参数。这串字符串直接传给xorm.NewEngine("mysql", dsn)，不能拆开、不能漏掉@tcp()包裹。
其中tcp(地址:端口)不可替换为/或localhost——某些MySQL配置下localhost会强制走Unix socket，而XORM只支持TCP协议连接，【漏写tcp()是90%初学者连接失败的根源】。
各字段含义与填写要点
用户名:密码：MySQL账户凭证，明文写入。若密码含特殊字符（如@ / ?），需URL编码，否则DSN解析会提前截断。
tcp(地址:端口)：地址推荐用127.0.0.1而非localhost；端口默认3306，若MySQL改过端口必须同步修改；括号()为语法必需，不能省略。
/数据库名：必须是已创建好的库名，XORM不会自动建库。若填错或为空，e.Ping()会返回Error 1045或Error 1049。
?后的查询参数：全部为键值对，用&连接，至少要包含charset=utf8mb4和parseTime=true，否则中文乱码、time.Time字段读取为零值。
关键查询参数详解
方法一：最小可用参数组合
必须带上charset=utf8mb4&parseTime=true&loc=Local。utf8mb4支持emoji和四字节Unicode字符，parseTime=true让XORM把MySQL的DATETIME转成Go的time.Time，loc=Local确保时区不漂移——三者缺一都会导致数据异常或panic。
方法二：生产环境推荐完整参数charset=utf8mb4&parseTime=true&loc=Local&timeout=5s&readTimeout=10s&writeTimeout=10s。超时参数防止网络抖动时goroutine永久阻塞，尤其在K8s环境中必须显式设置。
注意：timeout是连接建立阶段的超时，read/writeTimeout是后续通信超时，三者单位必须带s，写成5或5000会被忽略。
驱动导入不可省略
在main包或初始化文件顶部，必须添加匿名导入语句：_ "github.com/go-sql-driver/mysql"。没有这行，xorm.NewEngine会静默失败，报sql: unknown driver "mysql"错误——因为XORM本身不内置驱动，完全依赖database/sql标准库和第三方驱动协同工作。
这行代码不参与逻辑执行，但会触发mysql驱动的init()函数注册驱动名，是连接能跑起来的【硬性前提条件】。
验证连接是否生效
第一步：调用e.Ping()，它会发起一次轻量级握手，不执行SQL，仅检测底层TCP+认证是否通。
第二步：若Ping成功，再执行e.Sync2(new(User))等表同步操作，确认ORM层解析无误。
第三步：打印日志，开启e.ShowSQL(true)，观察控制台是否输出SELECT 1类探测语句——没日志说明引擎根本没启动。
