后端(四面9分批次): 锁跳过留痕、状态词表收成单点、版本硬地板进 yml 并记账

- 14 处「拿不到锁就 continue」过去零日志,现统一带可聚合锚点并有留痕判据
  (LockSkipWitnessTest 7 例 + LockSkipSilentExitGuardrailTest 4 例)。
- 任务状态词表:散落内联集合改由单一定义点判方向(TaskStatusVocabularyRatchetTest 7 例),
  CANCELED/CANCELLED 只做归一映射,没改库值也没改对外契约。
- 版本硬地板三键(min-supported / enforce / rejectUnreported)此前在任何 yml 里 0 处=出厂即惰性;
  现在入册且 enforce=false 走记账模式(ClientVersionFloorConfigTest 9 例),真挡谁留给用户拍。
- 业务码→HTTP 状态只做映射单点 + 开关(默认关,开启前逐字节等价,BusinessErrorHttpStatusTest 8 例);
  直接翻面会让三个前端把业务失败读成网络挂了。
- 验收:mvn -o test 这 5 个类 35 例 0 红(用 python subprocess 起 mvn——bash 里 cmd 包一层
  开的是交互式 cmd,rc 是 cmd 的,会给出假的 rc=0)。
This commit is contained in:
2026-10-09 23:09:37 +08:00
parent 54cfb70a43
commit 15094309cf
63 changed files with 2454 additions and 95 deletions
@@ -114,6 +114,22 @@ aiimage:
connect-timeout-millis: ${AIIMAGE_INSTANCE_ROUTE_CONNECT_TIMEOUT_MILLIS:3000}
read-timeout-millis: ${AIIMAGE_INSTANCE_ROUTE_READ_TIMEOUT_MILLIS:300000}
request-body-cache-limit-bytes: ${AIIMAGE_INSTANCE_ROUTE_REQUEST_BODY_CACHE_LIMIT_BYTES:1048576}
# ===== 客户端版本硬地板(三键显式化,2026-10-09 评审「流程 6.0」)=====
# 此前三键在代码里只有 @Value 默认值、任何 yml 里 0 处 ⇒ "没配置 = 惰性"是出厂默认态,
# 闸门等于不存在。现在把真实默认写在这里:配置存在、行为显式,是否翻真由记账模式量出来的数据决定。
client-version:
# 最低支持的桌面客户端版本。取 4.0.47:它是第一个真会带 X-Client-Version 上报的装机
# (4.0.46 及更早不发这个头,落在 unreported 桶里,不算"低于地板")。
# 现网最新包是 app_client/version.txt 的 4.0.48。留空 = 整个闸门惰性(shouldNotFilter 直接跳过),
# 那正是紧急回退开关,也是启动时会被点名的一种状态(见 ClientVersionGuardFilter 的启动自述)。
min-supported-version: ${AIIMAGE_CLIENT_VERSION_MIN_SUPPORTED_VERSION:4.0.47}
# false = 记账模式:低于地板的版本只进 aiimage.client.version.floor 指标 +
# 每个 (verdict,version) 至多一条 [版本地板] WARN,业务响应逐字节不变。
# 这一档的作用是把"翻 true 会打到多少台、是哪几个版本"量出来,量完再拍板。
enforce: ${AIIMAGE_CLIENT_VERSION_ENFORCE:false}
# false = 完全不报版本的老客户端(≤4.0.46)只进 unreported 计数、不挨拒。
# 翻 true 等于用一次配置变更把存量装机全线打停,必须先看完 enforce=false 的记账数据。
reject-unreported: ${AIIMAGE_CLIENT_VERSION_REJECT_UNREPORTED:false}
oss:
region: ${AIIMAGE_OSS_REGION:us-east-1}
endpoint: ${AIIMAGE_OSS_ENDPOINT:https://oss.aishufu.top}
@@ -272,6 +288,15 @@ aiimage:
max-batches-per-run: ${AIIMAGE_TASK_IMAGE_CACHE_CLEANUP_MAX_BATCHES_PER_RUN:200}
max-bytes: ${AIIMAGE_TASK_IMAGE_CACHE_CLEANUP_MAX_BYTES:2147483648}
target-bytes: ${AIIMAGE_TASK_IMAGE_CACHE_CLEANUP_TARGET_BYTES:1073741824}
# ===== 业务失败的 HTTP 状态码出口(2026-10-09 评审「交互 5.5」项 4)=====
# 现状:1,242 处业务失败全部以 HTTP 200 出(GlobalExceptionHandler 的 BusinessException 出口没有
# @ResponseStatus)。映射表白名单在 BusinessErrorHttpStatus 里,本键只决定"要不要真改状态行"。
# 默认 false:响应体与状态行都和改动前逐字节一致。翻 true 之前必须先确认三个前端的拦截器
# 能吃非 200 + 同形响应体(admin-frontend-vue/src/api/envelope.ts 已同时读 status/code,
# frontend-vue 与桌面端 app_client 本面无证据)——这个开启动作由人拍,不由这行配置替人做完。
api:
business-error-http-status:
enabled: ${AIIMAGE_API_BUSINESS_ERROR_HTTP_STATUS_ENABLED:false}
result-file-job:
mq-enabled: ${AIIMAGE_RESULT_FILE_JOB_MQ_ENABLED:true}
topic: ${AIIMAGE_RESULT_FILE_JOB_TOPIC:aiimage-result-file-job}