docs: 回填草原指南 TEST 验收结果

2026-07-13 22:31:33 +08:00
@@ -1,9 +1,14 @@
 # 草原指南视频上传校验与服务端时长

-> 日期：2026-07-13  
-> 后端 Issue：[HL #4949](https://git.1814.love:8443/wx/HL/issues/4949)  
-> 后端 PR：[HL #4961](https://git.1814.love:8443/wx/HL/pulls/4961)  
-> 当前状态：已合入 `dev`；尚未部署 TEST，尚未合入 `dev-v3`
+> 日期：2026-07-13
+>
+> 后端 Issue：[HL #4949](https://git.1814.love:8443/wx/HL/issues/4949)
+>
+> 后端 PR：[HL #4961](https://git.1814.love:8443/wx/HL/pulls/4961)、[HL #4962](https://git.1814.love:8443/wx/HL/pulls/4962)、[HL #4964](https://git.1814.love:8443/wx/HL/pulls/4964)
+>
+> 测试合并：[HL #4963](https://git.1814.love:8443/wx/HL/pulls/4963)、[HL #4965](https://git.1814.love:8443/wx/HL/pulls/4965)，均按 `dev` → `dev-v3` 进入 TEST
+>
+> 当前状态：TEST 已部署并通过真实 4K 上传确认；尚未合入 `main`、尚未部署正式环境

 ## 1. 本文件只说明视频上传链路

@@ -94,11 +99,19 @@

 ## 7. 前端联调清单

- [ ] 上传凭证请求不提交草原指南视频 `durationSeconds`。
- [ ] 大文件使用 `STS_MULTIPART` 直传 OSS。
+- [x] 后端 OpenAPI 与真实请求确认：上传凭证不需要草原指南视频 `durationSeconds`。
+- [x] 412400073 字节真实 4K 文件使用 `STS_MULTIPART` 直传 OSS。
 - [ ] 管理端时长只读展示确认接口返回值。
 - [ ] 原始 `moov` 位于文件尾部的视频确认返回 `250016`。
- [ ] 无损 faststart 重排后的真实 4K 原片确认成功并返回 `OSS_MP4_READY_V1`。
- [ ] `250015` 使用同一个 `materialId` 重试确认。
- [ ] 新建/替换内容只能选择 `OSS_MP4_READY_V1` 视频；历史原素材不变时仍可维护。
+- [x] 无损 faststart 重排后的真实 4K 原片确认成功并返回 `OSS_MP4_READY_V1`、`durationSeconds=83` 和自动封面。
+- [x] 首次确认因 fat JAR 类加载问题失败后，使用同一个 `materialId=2076658080942116865` 重试成功，未重复上传 412 MB 文件。
+- [x] 新建草原指南已实测只接受 `OSS_MP4_READY_V1` 视频；历史原素材不变时仍可维护。
 - [ ] 微信 Android/iOS 真机完成原片与重排文件的 A/B 验收。
+
+## 8. TEST 真实验证记录
+
+- User 部署任务：`1a2a42da`，`dev-v3`，8081/8181 双实例滚动成功；Nacos `test` 命名空间两实例均为 `healthy=true`、`enabled=true`。
+- 素材：`2076658080942116865`，文件大小 `412400073`，存储方 `OSS`，媒体状态 `OSS_MP4_READY_V1`，服务端时长 `83` 秒，自动封面存在。
+- fat JAR 回归：通过 Spring Boot `PropertiesLauncher` 直接加载最终候选 JAR，并解析同一真实 4K `moov`，返回 `durationSeconds=83 / OSS_MP4_READY_V1`。
+- OSS Range：请求 `bytes=0-1023` 返回 HTTP `206`、1024 字节和 `Content-Range`。
+- 仍未据此宣称真机音画同步通过；默认 Bucket 域名的微信 Android/iOS 真机播放、拖动、暂停恢复与音画同步必须由前端单独验收。