Skip to content

v2.1.2 — 状态机加固

Latest

Choose a tag to compare

@Evvvvvvvan Evvvvvvvan released this 11 Nov 10:28
· 4 commits to main since this release

本次为状态机加固:把审计出的隐式状态机缺陷中"会造成重复发货 / 丢结果 / 永久卡死"的部分收敛为带守卫的状态迁移。

履约与自动回复

  • 履约任务增加租约围栏: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 个用例。

升级说明

  1. 新增 Flyway 迁移 V19(merchant_task 租约列),升级时自动执行。
  2. 前端静态资源已重新构建,升级后建议强制刷新页面(Ctrl/Cmd + Shift + R)。
  3. 多副本部署仍需注意: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