图片上传、签名与缓存机制

```mermaid
flowchart LR
    APP["App 上传图片"] --> OSS["直传 OSS"]
    OSS --> KEY["业务接口提交 objectKey"]
    KEY --> DB["数据库保存 objectKey"]

    DB --> API["业务接口序列化"]
    API --> SIGN["生成带 auth_key 的 CDN URL"]
    SIGN --> JSON["返回业务 JSON"]

    JSON --> SP["SharedPreferences 业务缓存"]
    JSON --> IMG["图片组件"]

    IMG --> MEM{"Flutter ImageCache"}
    MEM -- 命中 --> SHOW["显示图片"]
    MEM -- 未命中 --> DISK{"CE 磁盘缓存"}
    DISK -- 命中 --> SHOW
    DISK -- 未命中 --> CDN["使用 signed URL 请求 CDN"]
    CDN -- 200 --> SAVE["写入磁盘和内存缓存"]
    SAVE --> SHOW
    CDN -- 403 --> FALLBACK["显示兜底图"]

    SP -->|"下次启动恢复旧业务 JSON"| IMG
```

flowchart TD
    A["进入页面"] --> B["读取旧业务 JSON"]
    B --> C["立即构建图片组件"]
    C --> D{"内存/磁盘图片命中？"}

    D -- 是 --> SHOW["立即显示"]
    D -- 否 --> OLD["使用旧 signed URL 请求 CDN"]

    OLD --> CHECK{"签名有效？"}
    CHECK -- 是 --> SAVE["缓存并显示"]
    CHECK -- 否 --> ERR["CDN 返回 403"]
    ERR --> FALLBACK["显示兜底图"]

    A --> API["后台请求最新业务接口"]
    API --> NEW["返回新 signed URL"]
    NEW --> REBUILD["页面数据更新"]

    REBUILD --> SAME["新旧 URL 对应相同 cacheKey"]
    SAME --> PROBLEM["Flutter 可能复用旧失败的图片流"]

flowchart TD
    A["进入页面"] --> B["立即恢复旧业务 JSON"]
    B --> C["立即构建图片 Widget"]
    C --> D{"内存/磁盘缓存命中？"}

    D -- 是 --> SHOW["立即显示图片"]
    D -- 否 --> OLD["立即请求旧 signed URL"]

    A --> API["后台请求最新业务接口"]

    OLD --> OK{"旧 URL 是否成功？"}
    OK -- 是 --> SAVE["按 objectKey 缓存并显示"]
    OK -- 否 --> FALLBACK["暂时显示兜底图"]

    API --> NEW["返回新 signed URL"]
    NEW --> SP["覆盖 SharedPreferences"]
    NEW --> UPDATE["setState 更新业务数据"]

    UPDATE --> KEY["底层 Widget Key 随 imageUrl 变化"]
    KEY --> RECREATE["重新创建 CE 图片 Widget"]

    RECREATE --> CACHE{"稳定 objectKey 缓存命中？"}
    CACHE -- 是 --> SHOW
    CACHE -- 否 --> RETRY["使用新 signed URL 请求 CDN"]
    RETRY --> SAVE

数据库媒体身份
= objectKey

CDN 边缘缓存 Key
= URL path / objectKey

App 磁盘图片缓存 Key
= objectKey

Flutter 内存图片缓存 Key
= 归一化后的 objectKey

当前图片 Widget 实例 Key
= signed URL

SharedPreferences
= 业务 JSON，包括接口当时返回的 signed URL