weicw-dshsa
2d185f0de6
问题（用户实测反馈）：金额列填「一万二千元」这类无法转换的内容时，EasyExcel 在
ExcelUtil.read(...) 阶段就抛 ExcelDataConvertException，根本走不到行级校验；
控制器只 catch ImportFailureException，异常穿透到全局处理器，用户看到的是
HTTP 500 + 「Convert data ... to class java.math.BigDecimal error」这类技术文案，
且完全拿不到失败明细。
影响面：全部 27 个导入接口（读阶段的 ExcelUtil.read 都在 try 内、只 catch
ImportFailureException），非维修记录独有。
改动：
- ImportFailureExcelUtil 新增三个能力（blade-common，公共层一次覆盖各模块）：
1) describeReadFailure：把 ExcelDataConvertException 转成
「第N行「列名」格式不正确：<原值>」，列名按列序号反查 @ExcelProperty；
2) readRawRows：以原始文本（Map）方式重读文件，不做类型转换因此绝不抛异常，
用于拿回「原表全部行」；
3) exportReadFailure：一站式兜底（重读 → 导出全量行 + 仅出错行带原因 +
按列标红），返回 false 表示非转换类异常，调用方继续抛出保持原行为。
- 26 个导入控制器在现有 catch 之后追加 catch(Exception) 兜底，未改动原有
行级校验与整批回滚逻辑。
验证：
- 实测维修记录/费用项/币种汇率三个模块：HTTP 500→200，返回全量明细，
文案如「第5行「费用」格式不正确：一万二千元」（行号经单行/四行文件双向校准）。
- 既有回归无退化：记录类 80/80、台账 32/32、港口码头 45/45、货物类型 24/24、
费用项 20/20、币种汇率 25/25。
- 新增 scripts/api-read-failure-test.sh（4 断言）固化该场景。
版权声明
- BladeX是一个商业化软件，系列产品知识产权归上海布雷德科技有限公司独立所有
- 您一旦开始复制、下载、安装或者使用本产品，即被视为完全理解并接受本协议的各项条款
- 更多详情请看：BladeX商业授权许可协议
答疑流程
- 遇到问题或Bug
- 业务型问题打断点调试尝试找出问题所在
- 系统型问题通过百度、谷歌、社区查找解决方案
- 未解决问题则进入技术社区进行发帖提问：https://sns.bladex.cn
- 将帖子地址发至商业群，特别简单三言两语就能描述清楚的也可在答疑时间内发至商业群提问
- 发帖的时候一定要描述清楚，详细描述遇到问题的重现步骤、报错详细信息、相关代码与逻辑、使用软件版本以及操作系统版本，否则随意发帖提问将会提高我们的答疑难度。
答疑时间
- 工作日：9:00 ~ 17:00 提供答疑，周末、节假日休息，暂停答疑
- 请勿私聊提问，以免被其他用户的消息覆盖从而无法获得答疑
- 答疑时间外遇到问题可以将问题发帖至技术社区，我们后续会逐个回复
授权范围
- 专业版：只可用于个人学习及个人私活项目，不可用于公司或团队，不可泄露给任何第三方
- 企业版：可用于企业名下的任何项目，企业版员工在未购买专业版授权前，只授权开发所在授权企业名下的项目，不得将BladeX用于个人私活
- 共同遵守：若甲方需要您提供项目源码，则需代为甲方购买BladeX企业授权，甲方购买后续的所有项目都无需再次购买授权
商用权益
- ✔️ 遵守商业协议的前提下，将BladeX系列产品用于授权范围内的商用项目，并上线运营
- ✔️ 遵守商业协议的前提下，不限制项目数，不限制服务器数
- ✔️ 遵守商业协议的前提下，将自行编写的业务代码申请软件著作权
何为侵权
- ❌ 不遵守商业协议，私自销售商业源码
- ❌ 以任何理由将BladeX源码用于申请软件著作权
- ❌ 将商业源码以任何途径任何理由泄露给未授权的单位或个人
- ❌ 开发完毕项目，没有为甲方购买企业授权，向甲方提供了BladeX代码
- ❌ 基于BladeX拓展研发与BladeX有竞争关系的衍生框架，并将其开源或销售
侵权后果
- 情节较轻：第一次发现警告处理
- 情节较重：封禁账号，踢出商业群，并保留追究法律责任的权利
- 情节严重：与本地律师事务所合作，以公司名义起诉侵犯计算机软件著作权
举报有奖
- 向官方提供有用线索并成功捣毁盗版个人或窝点，将会看成果给予 500～10000 不等的现金奖励
- 官方唯一指定QQ：1272154962