API Changelog Bot和Claude Opus 5
9ee36c0b94
changelog-filename-gate / validate (push) Failing after 2s
order-v3 的 InvoiceAdminService.issueInvoice / reuploadInvoice 与 InvoiceMpService.reissueInvoice 三处 @Lock4j 写了逐字相同的 keys 却都没写 name；lock4j 的 Redis 键在 name 缺省时退化成 「类全限定名+方法名」，于是三处各持一把锁。后果是 reupload ∥ reissue 会留下一单两张有效票。 本次三处补同一个 name = "order-invoice:issue"。PR #8043 → 09b8f2323 已合 dev-v3。 接口路径、方法、请求/响应字段、既有错误码全部零增删。唯一契约变化是新增一个可能返回的错误码 100503 （RESOURCE_LOCKED「资源被占用,请稍后重试」），且它以 HTTP 200 + body code 返回—— 前端只看 HTTP 状态码会把它当成功。 该码会触达小程序 C 端：reissue 经 hl-mp-service 两个入口透传 （MpV3InvoiceController:54 直接透传；MpInvoiceController:108 经 getCheckedData()， Result:143-148 用上游 code 原样重抛）。用户点「申请重开发票」时若财务端正在同一张票上操作， 等最多 3 秒后收到该提示；反向同理。此前这几条互不阻塞。 测试服证据（backend_status 因此才从 pending 转 deployed；此前门禁 E_BACKEND_PENDING 正确拦下过一次， 没有为换绿灯改状态，而是去把部署真的做了）：运行版本 5d14bc524， merge-base --is-ancestor 09b8f2323 5d14bc524 → YES。 ⚠️ 如实记：部署前 COMMIT 已是 5d14bc524（另一会话此前推上去的），本次重跑不等于「使它从不生效变生效」。 🔴 证据强度按实际收窄，没有拔高：redis-cli MONITOR 抓到键 lock4j:order-invoice:issue#order-invoice:issue:<invoiceId>、无方法名混入， 但 MONITOR 只跑了三个写口里的一个（issueInvoice）；另两处由代码同源 + 反射守卫用例 InvoiceIssueLockNameGuardTest（断言三处 name 非空且相等）覆盖，未在测试服上单独抓包。 正文里 §2/§3 原本写「同第 1 节，链路一致」会被读成「也实测过」，已改成明确写「未单独抓包」。 100503 未复现：并发两个 issueInvoice，一个 code=200、另一个 code=581502（INVOICE_CANNOT_ISSUE 业务状态守卫），不是锁超时码。原因是临界区极短（与 fleet 那轮 34 并发未触发同因）。 第二个请求被业务守卫拦下说明没产生并发脏写，但这是旁证不是互斥证据。 两面都写：路径源码级真实存在（已读码确认 + IT 里实测过等 3024ms），但测试服未能触发， 不代表更长事务／生产数据量下不会触发。 取证干净：三张票全是测试夹具（客户名「核团甲/乙/丙」，apply_reason 为 #7932 造数）， 改前均 REQUESTED/NULL/NULL，已按改前快照逐列 UPDATE 还原并复读一致， Redis --scan lock4j:*order-invoice* 复扫为空。过程中发生过一次 code=401（token 被别的会话顶掉）， 该次调用前无任何读数，已重登并把那段整个重做。 顺带修掉一个会挂门禁的文件名 bug：原名后缀写的是「小程序管理后台」，而 changelogs-v2/ 根目录 要求端类型字面量必须是「管理后台」，改名前文件名校验确实报 E_CLIENT。 Refs #7980 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>