Skip to content

利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short videos from a topic or keyword with an automated AI workflow.

fix(bgm): reject staged upload files when resolving background music

c020627169399cd8b07
diff --git a/app/services/bgm.py b/app/services/bgm.py
index a2109232..2fdbc715 100644
--- a/app/services/bgm.py
+++ b/app/services/bgm.py
@@ -334,7 +334,8 @@ def resolve_builtin_bgm_file(unsafe_path: str) -> str:
def resolve_bgm_file(unsafe_path: str) -> str:
"""
- 在用户上传目录和内置歌曲目录中解析 BGM,并拒绝两个白名单之外的路径。
+ 在用户上传目录和内置歌曲目录中解析 BGM,并拒绝两个白名单之外的路径与上传
+ 中断遗留的暂存文件。
文件名优先命中用户目录,同时保留 `output000.mp3`、绝对白名单路径和
`./resource/songs/output000.mp3` 等旧用法。新上传文件使用 UUID,正常情况下
@@ -345,6 +346,13 @@ def resolve_bgm_file(unsafe_path: str) -> str:
or Path(unsafe_path).suffix.lower() not in SUPPORTED_BGM_EXTENSIONS
):
raise ValueError("unsupported background music path")
+ if os.path.basename(str(unsafe_path)).lower().startswith(_INTERNAL_UPLOAD_PREFIX):
+ # 上传预检与最终保存都会在同一个目录里短暂创建 ``.bgm-upload-`` 前缀的
+ # 中间文件。它们带有合法的音频扩展名,但尚未完成校验,``_list_bgm_files``
+ # 已经把它们排除在随机 BGM 之外;解析入口必须给出同一个结论,否则
+ # API/CLI 传入的名称可以命中一个写入中断、内容不完整的中间文件。
+ # 用户传入的名称按不区分大小写比较,与 Windows/macOS 的文件系统一致。
+ raise ValueError("background music upload staging files are not selectable")
candidates = [unsafe_path]
if not os.path.isabs(unsafe_path):
diff --git a/test/services/test_bgm.py b/test/services/test_bgm.py
index 7b771431..a07cbd2b 100644
--- a/test/services/test_bgm.py
+++ b/test/services/test_bgm.py
@@ -364,6 +364,38 @@ class TestBackgroundMusicService(unittest.TestCase):
with self.assertRaises(ValueError):
bgm.resolve_builtin_bgm_file(invalid_path)
+ def test_resolve_rejects_staged_upload_left_by_an_interrupted_write(self):
+ """写入中断留下的暂存中间文件不能被解析成可用的背景音乐。
+
+ ``_list_bgm_files`` 已经把这些尚未完成校验的中间文件排除在随机 BGM
+ 之外,但 API 与 CLI 传入的 ``bgm_file`` 走的是 ``resolve_bgm_file``:
+ 同一个文件必须在两个入口得到同一个结论,否则客户端可以让任务引用一个
+ 内容不完整、无法解码的中间文件。
+ """
+
+ with tempfile.TemporaryDirectory() as uploaded_dir:
+ staged_name = f"{bgm._INTERNAL_UPLOAD_PREFIX}pending.m4a"
+ Path(uploaded_dir, staged_name).write_bytes(b"partial")
+ Path(uploaded_dir, "user.flac").write_bytes(b"uploaded")
+
+ with patch.object(bgm, "uploaded_bgm_dir", return_value=uploaded_dir):
+ for candidate in (
+ staged_name,
+ os.path.join(uploaded_dir, staged_name),
+ # Windows 与 macOS 的文件系统不区分大小写,暂存前缀的判定
+ # 也必须如此,否则同一个文件会因为大小写写法不同而复活。
+ staged_name.upper(),
+ ):
+ with self.subTest(candidate=candidate):
+ with self.assertRaises(ValueError):
+ bgm.resolve_bgm_file(candidate)
+
+ # 普通上传文件仍然可以正常解析(反向对照)。
+ self.assertEqual(
+ bgm.resolve_bgm_file("user.flac"),
+ os.path.realpath(os.path.join(uploaded_dir, "user.flac")),
+ )
+
if __name__ == "__main__":
unittest.main()