线上为XORM表新增字段需四步：先校验模型与tag一致性，再手动构造带默认值的ALTER语句并测试，接着双阶段上线（先加字段后启逻辑），最后按需补全历史数据。
在使用XORM框架的Go项目中，线上服务运行时需为已有表新增字段，又不能停机、不能丢失数据、不能引发SQL执行错误——这是高频且高危的操作场景。
确认当前表结构与XORM模型一致性
打开对应struct定义文件，检查该结构体是否已添加新字段（例如新增 IsArchived bool `xorm:"not null default false"`），并确认字段名、类型、tag标注与预期完全匹配。
这一步不可跳过：XORM的Sync2()或Sync()不会自动推断“新增字段应设默认值”，若struct中字段无xorm tag或tag写错（如漏掉default false），执行时可能报错或导致数据库字段为NULL而业务panic。
生成并验证ALTER语句
手动构造符合MySQL/PostgreSQL语法的ALTER语句，例如：ALTER TABLE user ADD COLUMN is_archived TINYINT(1) NOT NULL DEFAULT 0 AFTER updated_at;
注意字段位置（AFTER）和默认值必须显式指定，否则线上已有行该列值为NULL，而XORM读取时若struct字段是非nil类型（如bool、int64）会触发零值覆盖或scan失败。
在测试库执行该语句，再用SELECT * FROM user LIMIT 1确认新字段存在且默认值生效；同时用XORM执行engine.Get(&user)验证能否正常反序列化。
双阶段上线：先加字段，再启用逻辑
第一步：在低峰期执行ALTER语句，确保DBA或运维确认执行成功、无锁表、无复制延迟。
第二步：发布新代码包，其中struct已含字段且tag完整，但业务逻辑暂不读写该字段（即保持“只存不读”状态）。
第三步：观察1～2个监控周期（如30分钟），确认无panic、无SQL错误、无慢查询告警，且binlog/redo log无异常增长。
第四步：放开业务逻辑对该字段的读写，例如开始设置user.IsArchived = true并调用engine.Update(&user)。
【关键前提】整个过程中，旧版本代码仍可正常运行——因为XORM对struct中多出的字段默认忽略，不会因字段不存在而报错；但旧代码写入时不会设置该字段，所以依赖默认值兜底。
处理历史数据补全（按需）
方法一：后台任务分批UPDATE。适合数据量大、允许最终一致的场景。例如每批次更新1000条，sleep 100ms，避免拖垮主库。
方法二：读时惰性填充。首次GET到某条记录且IsArchived为false时，主动UPDATE设为真实值并缓存。适用于访问有明显热点、且补全时机不敏感的字段。
方法三：禁止补全。若该字段纯属新增功能标识（如灰度开关），历史数据统一走默认值即可，无需额外操作。
