必须升级Go至1.21+，替换log为slog，显式指定i18n路径，Docker中挂载/usr/irissys/mgr以保障IRIS数据持久化，否则编译失败或运行时panic。
将Iris框架从旧版升级至v12时，需重点应对Go版本兼容性、日志模块变更、本地化加载方式调整及Docker部署数据持久化逻辑变化，否则项目无法编译或运行时panic。
确认并升级Go运行时版本
执行 go version 检查当前Go版本。若低于1.21，则log/slog包缺失会导致构建失败——Iris v12已弃用log而全面采用标准库slog。
必须升级至Go 1.21或更高版本。Windows用户可下载官方安装包覆盖安装；macOS/Linux推荐使用gvm切换：gvm install go1.21.10 && gvm use go1.21.10。
【不升级Go 1.21+将直接导致go build报错：package log/slog is not in GOROOT】
替换旧版日志调用方式
方法一：全局替换log.Print/Printf为slog.Info/Error，例如将log.Printf("server started on %s", addr)改为slog.Info("server started", "addr", addr)。
方法二：保留原有log包但桥接至slog，需在main入口添加：log.SetOutput(slog.NewTextHandler(os.Stdout, nil).Writer())，此方式仅作过渡，不推荐长期使用。
注意：Iris v12内部已移除对log的依赖，自定义中间件或handler中若仍调用log且未桥接，运行时将静默丢失日志。
重构本地化（i18n）加载逻辑
第一步：检查app.I18n.Load()调用是否仍传入./locales/**/*这类模糊glob路径——v12已废弃通配符递归匹配，必须显式指定语言子目录层级。
第二步：将原写法app.I18n.Load("./locales/**/*", "en-US", "zh-CN")改为app.I18n.Load("./locales/*/*", "en-US", "zh-CN")，确保路径模式与实际目录结构一致（如./locales/zh-CN/home.yml）。
第三步：若使用go-bindata嵌入本地化文件，LoadAssets签名已变更——第二个参数不再接受Asset函数指针，而需传入func(name string) ([]byte, error)类型闭包，否则编译报错。
适配Docker环境下的IRIS数据持久化机制
若项目集成InterSystems IRIS作为向量库并运行于Docker，v12.1起默认启用Durable %SYS机制。需在docker-compose.yml中显式挂载/usr/irissys/mgr目录到宿主机持久卷，例如：
volumes: - ./iris-data:/usr/irissys/mgr
未挂载该路径会导致容器重建后所有命名空间、类定义、持久化对象全部丢失，且无任何错误提示——仅表现为首次请求返回空结果或500。
