fix(api): 修复全量接口扫描发现的 500 —— 由 70 个降到 0 个
基于 /v3/api-docs 自动发现 4173 个接口做全量探测(scripts/api-500-probe/probe_500.py),
第一轮 70 个返回 500,逐一定位修复后复测为 0。
1. 导出类接口(Excel 写不出去)
- 新增 LocalTimeConvert:FastExcel 不支持 LocalTime,班次/考勤规则导出直接 500
- 质检方案 types(List<Integer>)、生产任务 pauseRecords/assigneeUserIds/assigneeUserNames
改用 JsonConvert 承载,避免 Can not find 'Converter' support class List
2. 归档台账导出(MybatisPlusException: can't found IPage for args!)
- exportArchiveExcel 传 Page 为 null,改为按 pageNo/pageSize 构造 Page
3. BPM 流程定义
- page:sort 为 null 时 Comparator.comparing 抛 NPE,改用 nullsLast
- get:id 与 key 都为空时给出业务提示,不再让 Flowable 抛 key is null
4. 文件下载(CacheLoader.InvalidCacheLoadException)
- configId 无效时按 404 返回,不再是 500
5. 全局异常处理
- MultipartException(导入接口未传文件)→ 400
- 其它 HttpMessageNotReadableException(报文结构不匹配)→ 400
- buildExceptionLog 对 NOT NULL 列做空值兜底,避免异常日志本身插入失败
6. 请求体缺少必填校验(空请求体直接打到 DB 报 Field 'xxx' doesn't have a default value)
- MDM 物料/计量单位/品牌/分类/仓库 SaveReqVO 加 @NotBlank
- MES 资料审核 SaveReqVO 加 @NotBlank/@NotNull
- BI 图表配置/数据源配置 DO 加 @NotBlank/@NotNull
- 示例 demo03 course/grade DO 加 @NotNull
已完成第二轮验证:4173 个接口中 500 数量为 0;导出类接口实际返回 xlsx 字节流。