fix: add ffmpeg to API runtime image for cover fallback #1362

Merged

xiaoxia merged 1 commits from fix/api-ffmpeg-missing into develop 2026-08-13 21:40:23 +08:00

Conversation 5 Commits 1 Files Changed 1

+2 -1

xiaoxia commented 2026-08-13 21:25:52 +08:00

Owner

Copy Link

Copy Source

Problem

PR #1360 introduced FFmpeg-based frame extraction fallback for cover generation, but API Docker image does not include FFmpeg binary.

• Worker image has FFmpeg via worker-base-runtime
• API image runtime stage only has libpq5

Cover fallback path calls subprocess with ffmpeg, gets FileNotFoundError -> 500 error.

Fix

Add ffmpeg to apt-get install in runtime stage of infra/docker/api.Dockerfile.

## Problem PR #1360 introduced FFmpeg-based frame extraction fallback for cover generation, but API Docker image does not include FFmpeg binary. - Worker image has FFmpeg via worker-base-runtime - API image runtime stage only has libpq5 Cover fallback path calls subprocess with ffmpeg, gets FileNotFoundError -> 500 error. ## Fix Add ffmpeg to apt-get install in runtime stage of infra/docker/api.Dockerfile.

xiaoxia added 1 commit 2026-08-13 21:25:52 +08:00

fix: add ffmpeg to API runtime image for cover fallback ... 7eab4bc508

PR #1360 introduced FFmpeg-based frame extraction as fallback for cover
generation, but the API Docker image did not include FFmpeg binary.
Worker image already has it via worker-base-runtime, but API image only
had libpq5 in its runtime stage.

This caused subprocess calls to fail with FileNotFoundError when the
cover generation tried to use _extract_frames_with_ffmpeg fallback.

Fix: add ffmpeg to apt-get install in runtime stage of api.Dockerfile.

auto-approve-bot commented 2026-08-13 21:27:06 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. [infra/docker/api.Dockerfile] 依赖管理规范
   • 使用了 --no-install-recommends 参数，避免引入不必要的非直接依赖，有助于减小最终镜像体积。
2. [infra/docker/api.Dockerfile] 镜像优化
   • 在安装完依赖后立即执行 rm -rf /var/lib/apt/lists/*，有效清理了 apt 缓存文件，这是减小 Docker 镜像大小的标准最佳实践。
3. [infra/docker/api.Dockerfile] 注释维护
   • 及时更新了注释，准确说明了新增 ffmpeg 包的业务用途（封面兜底取帧），便于后续维护。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-13 13:27:06 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **[infra/docker/api.Dockerfile] 依赖管理规范** - 使用了 `--no-install-recommends` 参数，避免引入不必要的非直接依赖，有助于减小最终镜像体积。 2. **[infra/docker/api.Dockerfile] 镜像优化** - 在安装完依赖后立即执行 `rm -rf /var/lib/apt/lists/*`，有效清理了 apt 缓存文件，这是减小 Docker 镜像大小的标准最佳实践。 3. **[infra/docker/api.Dockerfile] 注释维护** - 及时更新了注释，准确说明了新增 `ffmpeg` 包的业务用途（封面兜底取帧），便于后续维护。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-13 13:27:06 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

gitea-actions bot commented 2026-08-13 21:27:23 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1362
预览链接	https://pr-1362.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1362 | | 预览链接 | [https://pr-1362.preview.xiaoxiajianji.com](https://pr-1362.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot approved these changes 2026-08-13 21:35:30 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-13 21:35:30 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia merged commit 0896f3e161 into develop 2026-08-13 21:40:23 +08:00

gitea-actions bot commented 2026-08-13 21:41:35 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1362 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1362 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1362