# 影片 Seek 異常問題

## 問題描述

**影片檔案**: `Gamma 8-Director Chih-Lin Yang Shares His Experience:楊智麟導演經驗分享.mp4`
**UUID**: `d3f9ae8e471a1fc4d47022c66091b920`
**大小**: 219.0 MB
**時長**: 298.67 秒（約 5 分鐘）

**症狀**:
- 3 分鐘後 seek 異常
- 異常行為：
  1. 回到影片開頭
  2. 跳到影片結尾

## 診斷結果

### ffprobe 檢測錯誤

```
[h264 @ 0x7ad048e00] Invalid NAL unit size (49912 > 22668).
[h264 @ 0x7ad048a80] missing picture in access unit with size 22672
[h264 @ 0x7ad048a80] Error splitting the input into NAL units.
```

### 影片結構分析

| 項目 | 數值 | 狀態 |
|------|------|------|
| Codec | H.264 High Profile | ✅ |
| 解析度 | 1920x1080 | ✅ |
| 幀率 | 29.97 fps (30000/1001) | ✅ |
| Keyframe 間距 | ~28 幀 (~1 秒) | ✅ |
| moov atom 位置 | 28 bytes | ✅ 正確（在開頭） |
| stss seek table | 存在 | ✅ |
| NAL units | **損壞** | ❌ |

### Range Requests 測試

Core API Range requests 運作正常：

```
curl -I -H "Range: bytes=150000000-150001000" ...
HTTP/1.1 206 Partial Content
content-range: bytes 150000000-150001000/229638144
```

## 根本原因

**影片檔案本身有損壞的 NAL units**，非 Studio 或 Core API 問題。

瀏覽器的 H.264 解碼器在遇到損壞的 NAL units 時會：
1. 無法正確解碼目標幀
2. 嘔試從最近的 keyframe 恢復
3. 若恢復失敗，跳回開頭或結尾

## 解決方案

### 方案 1: 重新封裝（Remux）

不重新編碼，僅重新打包容器：

```bash
ffmpeg -i "/Users/accusys/momentry/var/sftpgo/data/demo/Gamma 8-Director Chih-Lin Yang Shares His Experience:楊智麟導演經驗分享.mp4" \
  -c copy \
  "/Users/accusys/momentry/var/sftpgo/data/demo/Gamma 8-Director Chih-Lin Yang Shares His Experience_fixed.mp4"
```

優點：快速、不損失畫質
缺點：可能無法修復損壞的幀

### 方案 2: 重新編碼（Transcode）

完整重新編碼：

```bash
ffmpeg -i "/Users/accusys/momentry/var/sftpgo/data/demo/Gamma 8-Director Chih-Lin Yang Shares His Experience:楊智麟導演經驗分享.mp4" \
  -c:v libx264 -crf 18 \
  -c:a aac -b:a 128k \
  "/Users/accusys/momentry/var/sftpgo/data/demo/Gamma 8-Director Chih-Lin Yang Shares His Experience_reencoded.mp4"
```

優點：完整修復損壞的幀
缺點：耗時、些微畫質損失

### 方案 3: 重新註冊

修復後需重新註冊到系統：

```bash
# 取消註冊舊檔案
curl -X POST http://localhost:8888/api/v1/unregister \
  -H "Content-Type: application/json" \
  -d '{"file_uuid": "d3f9ae8e471a1fc4d47022c66091b920"}'

# 註冊新檔案
curl -X POST http://localhost:8888/api/v1/files/register \
  -H "Content-Type: application/json" \
  -d '{"file_path": "/path/to/fixed_video.mp4"}'
```

## 預防措施

### 上傳時驗證

可在檔案註冊時加入驗證：

```bash
ffprobe -v error -count_frames -select_streams v:0 \
  -show_entries stream=codec_name \
  -of default=noprint_wrappers=1 input.mp4
```

若有錯誤輸出，標記檔案為「需要檢查」或自動嘗試修復。

### 定期檢查腳本

```bash
#!/bin/bash
# check_videos.sh
for file in /path/to/videos/*.mp4; do
  errors=$(ffprobe -v error -count_frames "$file" 2>&1 | grep -i "invalid\|error\|corrupt")
  if [ -n "$errors" ]; then
    echo "ISSUE: $file"
    echo "$errors"
  fi
done
```

## 其他影片測試

測試其他影片均正常，確認問題僅限於此特定檔案。

## 狀態

- [x] 問題診斷完成
- [ ] 嘗試 remux 修復
- [ ] 嘗試 transcode 修復（若 remux 失敗）
- [ ] 重新註冊檔案
- [ ] 驗證 seek 功能正常

---

**建立日期**: 2026-07-22
**相關文件**: 
- `/Users/accusys/momentry_studio/docs/core-api-usage.md`
- `/Users/accusys/momentry_studio/docs/core-api-fix-video-range.md`