fix(clips): P0 自建模板 from-assets 400 直接查 clip_configs 表兜底 #1596

Merged

xiaoxia merged 1 commits from fix/from-assets-400-clip-config-fallback into develop 2026-09-01 12:03:00 +08:00

Conversation 2 Commits 1 Files Changed -

xiaoxia commented 2026-09-01 07:37:22 +08:00

Owner

Copy Link

Copy Source

P0 修复：自建模板 from-assets 400（所有自建模板选素材流程全断）

根因

_get_template_segments 中 tpl_svc.list_clip_configs(template_id) 内部调用 get_template_or_raise → 模板主体在 edit_templates 新表不存在 → ValueError → 被 except Exception 捕获 → 回退旧 template_segments 表 → 数据已迁移至 template_clip_configs 新表 → 返回空列表 → 400 "模板没有片段配置"。

数据规模：全库 583 个自建模板主体在旧表 templates、片段配置在新表 template_clip_configs，全部受影响。

修复

在 except 块与旧系统回退之间新增一段直接查 template_clip_configs 表的逻辑：

• SQLAlchemyTemplateClipConfigRepository(db).list_by_template(template_id)
• 片段表自带 template_id 外键，不依赖模板主表

三级回退链

1. 新模板系统（主表存在）→ 原逻辑不变
2. 主表不存在 → 直接查 clip_configs 表兜住（新路径）
3. 直接查表也失败 → 回退旧 template_segments 表
4. 全部失败 → 返回空

不改

• edit_template_service.py 公共方法签名
• clip_config_repo.list_by_template 行为
• 旧模板兼容逻辑

测试

8 个单测覆盖三级回退链：

• 新系统正常返回
• 主表缺失 + 直接查表成功（P0 核心场景）
• 主表缺失 + 直接查表空 + 旧系统回退
• 全部失败返回空
• 直接查表排序
• None duration 默认值
• 新系统返回空列表时继续直接查表
• 正常模板不受影响

验收

• staging 上用测试账号（自建模板「混剪8/31」template_id=4694c1be3a6f42c5ba737e5c0909a294）走完 AI 选素材 → from-assets，不再 400

## P0 修复：自建模板 from-assets 400（所有自建模板选素材流程全断） ### 根因 `_get_template_segments` 中 `tpl_svc.list_clip_configs(template_id)` 内部调用 `get_template_or_raise` → 模板主体在 `edit_templates` 新表不存在 → `ValueError` → 被 `except Exception` 捕获 → 回退旧 `template_segments` 表 → 数据已迁移至 `template_clip_configs` 新表 → 返回空列表 → 400 "模板没有片段配置"。 数据规模：全库 583 个自建模板主体在旧表 `templates`、片段配置在新表 `template_clip_configs`，全部受影响。 ### 修复 在 except 块与旧系统回退之间新增一段直接查 `template_clip_configs` 表的逻辑： - `SQLAlchemyTemplateClipConfigRepository(db).list_by_template(template_id)` - 片段表自带 `template_id` 外键，不依赖模板主表 ### 三级回退链 1. 新模板系统（主表存在）→ 原逻辑不变 2. 主表不存在 → 直接查 `clip_configs` 表兜住（**新路径**） 3. 直接查表也失败 → 回退旧 `template_segments` 表 4. 全部失败 → 返回空 ### 不改 - `edit_template_service.py` 公共方法签名 - `clip_config_repo.list_by_template` 行为 - 旧模板兼容逻辑 ### 测试 8 个单测覆盖三级回退链： - 新系统正常返回 - 主表缺失 + 直接查表成功（P0 核心场景） - 主表缺失 + 直接查表空 + 旧系统回退 - 全部失败返回空 - 直接查表排序 - None duration 默认值 - 新系统返回空列表时继续直接查表 - 正常模板不受影响 ### 验收 - [ ] staging 上用测试账号（自建模板「混剪8/31」template_id=4694c1be3a6f42c5ba737e5c0909a294）走完 AI 选素材 → from-assets，不再 400

xiaoxia added 1 commit 2026-09-01 07:37:22 +08:00

fix(clips): 自建模板 from-assets 400——直接查 clip_configs 表兜底 ... 83cb632653

根因：_get_template_segments 中 tpl_svc.list_clip_configs() 内部调用
get_template_or_raise → 模板主体在 edit_templates 新表不存在 →
ValueError 被 except 捕获 → 回退旧 template_segments 表 → 数据已迁移
至 template_clip_configs → 返回空 → 400 "模板没有片段配置"。

修复：在 except 块与旧系统回退之间新增一段直接查 template_clip_configs
表的逻辑（SQLAlchemyTemplateClipConfigRepository.list_by_template），
绕过主表校验，片段表自带 template_id 外键即可独立查询。

三级回退链：
1. 新模板系统（主表存在）→ 原逻辑不变
2. 主表不存在 → 直接查 clip_configs 表兜住（新路径）
3. 直接查表也失败 → 回退旧 template_segments 表
4. 全部失败 → 返回空

新增 8 个单测覆盖三级回退链全部路径。

gitea-actions bot commented 2026-09-01 07:43:32 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-09-01 07:44:37 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] c08a064e55

xiaoxia referenced this issue from a commit 2026-09-01 07:48:09 +08:00

fix(clips): P0 自建模板 from-assets 400——直接查 clip_configs 表兜底 (#1596)

xiaoxia referenced this issue from a commit 2026-09-01 11:29:04 +08:00

chore: trigger CI for PR #1596

xiaoxia added 1 commit 2026-09-01 11:29:04 +08:00

chore: trigger CI for PR #1596 4396c6be08

xiaoxia merged commit 6ea77725a5 into develop 2026-09-01 12:03:00 +08:00

gitea-actions bot commented 2026-09-01 12:06:48 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

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#1596