要在Docker容器中让XORM稳定连接数据库，必须确保网络可达性、DSN参数精确匹配容器内环境，并配置连接池与字段校验：1. 使用服务名而非localhost；2. DSN中host填服务名或DNS解析名，port为容器内端口；3. 设置MaxIdleConns、MaxOpenConns及ConnMaxLifetime；4. 加载配置后校验Port、User、Name非空。
要在Docker容器中让XORM框架稳定连接数据库，必须确保网络可达性、DSN参数精确匹配容器内运行时环境，并规避宿主机与容器间端口映射导致的地址误配。
确认数据库服务已就绪并可被应用容器访问
启动MySQL或PostgreSQL容器时，不能仅依赖localhost或127.0.0.1——这些在应用容器内部指向的是它自己，而非数据库容器。必须使用Docker网络中的服务名（如mysql）或自定义桥接网络的IP段内可达地址。
若用docker-compose编排，确保应用服务与数据库服务在同一networks下，例如共用app-network；否则ping mysql会失败，XORM初始化直接panic。
这一步操作起来很简单，直接把文件拖进去就行。
构造正确的DSN字符串
DSN格式为：user:pass@tcp(host:port)/dbname?charset=utf8mb4，其中host必须填写容器网络内可解析的地址。
方法一：使用Docker Compose服务名
当数据库服务名为db、端口映射为3306时，DSN中host填db，不是localhost或172.18.0.2——后者可能随重启变化，且硬编码破坏可移植性。
方法二：使用Docker内置DNS解析名
Docker守护进程为每个容器在bridge网络中分配DNS记录，形如容器名.网络名。若数据库容器名为pg-prod、网络名为backend，则host可写pg-prod.backend。
【DSN中port必须与容器内实际监听端口一致，不是宿主机映射端口】。例如PostgreSQL容器内监听5432，即使你映射了-p 5433:5432，DSN仍须写5432。
配置连接池参数防止超时中断
第一步：设置最大空闲连接数
XORM默认空闲连接数为2，高并发场景下极易耗尽，引发“too many connections”错误。应在Init()中显式调用engine.SetMaxIdleConns(cfg.MaxIdleConn)，建议设为5～10。
第二步：限制最大打开连接数
数据库服务本身有连接上限（如MySQL默认151），XORM的SetMaxOpenConns不可超过该值，否则部分连接请求会被拒绝。生产环境建议设为数据库上限的70%～80%。
第三步：启用连接存活检测
在长连接空闲后，底层TCP可能被防火墙或云厂商SLB中断。需开启engine.SetConnMaxLifetime（如2小时）和SetConnMaxIdleTime（如30分钟），避免复用已断开的连接。
不设置ConnMaxLifetime会导致凌晨批量任务执行时大量报read: connection reset by peer。
加载配置时校验结构体字段完整性
从Viper读取DB配置到cfg struct时，若toml或yaml中缺失Port字段，Go会将其初始化为0，导致DSN拼出@tcp(host:0)——XORM尝试连接:0端口，立即返回dial tcp: missing port in address并panic。
因此，在viper.UnmarshalKey("db", &cfgs)之后，必须对每个实例的Port、User、Name做非零/非空检查，任一为空则提前log.Fatal。
注意：Viper对int类型字段未配置时默认为0，这不是bug，是Go语言零值特性，必须主动防御。
