当多个Django URL路径配置为空字符串（""）时，Django仅匹配第一个路径，导致所有表单（无论action指向哪个命名URL）均被路由到首个视图，引发“点击‘开始转录’却触发文件上传逻辑”的典型路由错误。
当多个django url路径配置为空字符串（`""`）时，django仅匹配第一个路径，导致所有表单（无论`action`指向哪个命名url）均被路由到首个视图，引发“点击‘开始转录’却触发文件上传逻辑”的典型路由错误。
问题根源在于 transcribe/urls.py 中的 URL 配置存在严重冲突：
# ❌ 错误配置：两个空路径，无法区分
urlpatterns = [
path("", views.transcribeSubmit, name="transcribeSubmit"),
path("", views.initiate_transcription, name="initiate_transcription"),
]
Django 的 URL 解析器按顺序匹配，一旦遇到第一个 path("") 就立即终止匹配并调用 transcribeSubmit，后续的 path("") 永远不会生效。因此，尽管 transcribe-complete.html 中的表单明确设置了 action="{% url 'initiate_transcription' %}"，实际请求仍被路由至 transcribeSubmit 视图——这正是用户观察到“点击按钮却触发上传逻辑”的根本原因。
✅ 正确做法是为每个视图分配唯一、语义清晰的路径前缀，确保 URL 路由可预测且可维护：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
# ✅ 正确配置：显式、非重叠的路径
from django.urls import path
from . import views
urlpatterns = [
path("submit/", views.transcribeSubmit, name="transcribeSubmit"),
path("initiate/", views.initiate_transcription, name="initiate_transcription"),
]
同时，请确认 transcribe-complete.html 中的 {% url %} 模板标签已正确引用该命名空间（无需修改，因 name 未变），但需确保其生成的 URL 实际对应新路径。例如，{% url 'initiate_transcription' %} 现在将渲染为 /transcribe/initiate/（前提是主 URL 配置中 path('transcribe/', include('transcribe.urls')) 保持不变）。
⚠️ 注意事项：
- JavaScript 表单拦截逻辑需同步适配：当前 JS 使用 form.getAttribute('action') 获取提交地址，只要 Django 模板正确渲染了
- CSRF 处理：initiate_transcription 视图返回 JsonResponse，但 JS 中未处理响应数据。建议在 xhr.onreadystatechange 中补充成功状态处理（如 xhr.readyState === 4 && xhr.status === 200），并根据 {'status': 'success'} 做 UI 反馈（如禁用按钮、显示加载提示）。
- 安全性增强：initiate_transcription 当前仅依赖 session 数据校验，生产环境应增加文件存在性验证（如 os.path.exists(file_path)）及权限控制（防止会话劫持后恶意触发）。
总结：URL 设计是 Django 应用路由稳定性的基石。永远避免多个 path("") 共存；优先采用 RESTful 风格路径（如 /submit/, /initiate/, /status/），既提升可读性，也杜绝隐式覆盖风险。修复后，表单提交行为将严格遵循模板中声明的 name，实现预期的业务流程解耦。
