线上问题复盘根因分析

核心原则查询必须带全所有必要过滤条件（租户ID/连锁ID/机构ID），结果集必须校验唯一性，禁止用数组下标定位业务数据。

核心原则跨系统同步时必须对齐字段约束（必填/非必填），非必填字段写入前做空值判断并赋默认值，不能直接将空值跨系统传递。

核心原则代码变更时必须全链路审视关联表、关联模块、定时任务、配置项的参数传递；回滚时用 diff 逐文件确认；组件替换时逐参数对比新旧接口签名。

核心原则代码假设的数据格式必须与历史实际数据对齐；新增数据校验时同步清理历史异常数据；对历史残留边界数据（同名记录、字母编码、旧格式）做兼容兜底。

核心原则依赖升级前执行 mvn dependency:tree 检查传递依赖冲突；新依赖注明版本，由架构统一管理全局基线；选择各功能均兼容的中间版本。

核心原则接收外部数据或前端提交时，服务端必须校验数据内部一致性（单据号/金额/品牌等关键字段必须与当前业务状态匹配），关键字段以服务端档案为准，禁止信任前端/外部传入。