Repository navigation
本次为状态机加固:把审计出的隐式状态机缺陷中"会造成重复发货 / 丢结果 / 永久卡死"的部分收敛为带守卫的状态迁移。
履约与自动回复
- 履约任务增加租约围栏:
completeTask/retryOrFailTask必须匹配lease_owner,租约被抢占后旧执行器无法再写入完成/失败结果。 markTaskReviewRequired不再把COMPLETED订单降级为待人工核对;deferForRisk只作用于PENDING/PROCESSING/RETRY_WAIT,终态不受影响。- 发货私聊
markDeliveryMessageSent要求delivery_message_state = 2,避免超时重试与并发发送者互相覆盖。 - 自动回复状态迁移拆成"成功/失败"两条带守卫的语句:成功只接受
state = 2且校验租约归属,失败不会覆盖终态。 - 自动回复延时任务先按
(账号, 会话, pnmId)去重,重连补推的旧消息不再取消正在等待的回复。 - 收货后话术的乐观更新失败时跳过本轮,避免重复发送。
运营任务
- 新增迁移
V19:merchant_task增加lease_owner/lease_expire_time。 claim写入租约,complete/fail必须由租约持有者执行,避免双执行器重复发布。
卡密与凭证
- 外部供货的卡密预占现在可以正常释放(
releaseReservation不再按仓库来源过滤),不再永久锁死仓库。 - 外部卡密请求重试不再累加
exception_revision,人工确认不会被无意义地作废。 - WebSocket 返回
500不再把 Cookie 标记为过期(仅 401 与明确的过期信号触发),避免瞬时故障让账号从所有链路消失。 - 账号状态统一为
-2 需要验证(实体注释与前端文案一致),历史-1仍兼容读取。 - 登录失败计数修复:计数器不再被
put覆盖,连续失败 5 次会真正触发锁定。
连接与同步
- WebSocket 停止流程与启动流程共用账号锁,心跳线程的拆卸不会再误关刚建立的新连接。
- Token 刷新成功、人工重启后清理重连/滑块退避状态,避免零延迟重连风暴与陈旧退避。
- 商品列表分页未完整拉取时,不再把未拉取页的商品标记为已删除。
前端
- 待处理订单自动发货单飞,避免定时器叠加触发重复发货。
- 扫码登录在确认后先停止轮询,避免重复创建账号。
- 商品同步轮询失败后复位状态,刷新入口不再永久禁用。
- 连接状态丢弃过期响应;上传进度定时器不再泄漏。
- 自动发货保存不再强制打开"自动确认发货";回复开关失败回滚到请求前的值。
测试
- 新增状态守卫契约测试(反射断言 SQL 守卫)与登录锁定、缓存计数回归测试,共 17 个用例。
升级说明
- 新增 Flyway 迁移
V19(merchant_task租约列),升级时自动执行。 - 前端静态资源已重新构建,升级后建议强制刷新页面(Ctrl/Cmd + Shift + R)。
- 多副本部署仍需注意:WebSocket 连接状态、风控熔断、人工接管缓存仍是进程内状态。
镜像:ghcr.io/evvvvvvvan/xianyusmart:v2.1.2 / :latest
升级前请先备份数据库:本次包含 Flyway 迁移 V19(merchant_task 增加租约字段)。
# 方式一:替换 JAR
cp /opt/xianyuSmart/app.jar /opt/xianyuSmart/app.jar.bak
cp xianyusmart-2.1.2.jar /opt/xianyuSmart/app.jar
docker compose -f /opt/xianyuSmart/compose.yaml restart app
# 方式二:使用镜像
docker pull ghcr.io/evvvvvvvan/xianyusmart:v2.1.2
export APP_IMAGE=ghcr.io/evvvvvvvan/xianyusmart:v2.1.2
docker compose up -d