always raise 404 when create a agent in dev mode

问题场景

用户在 Dify 1.16.0-rc1 版本中，以 Self Hosted（源码部署）方式运行前端开发模式（dev mode），在创建 Agent 时始终触发 404 错误，界面上出现错误提示 toast。

报错原文

always raise 404 when create a agent in dev mode
POST /console/api/agents → 404 Not Found

原因分析

可能原因是 Dify 1.16.0-rc1 合并了 PR #37465 的 Agent v2 路由统一改动，旧的 /agents（复数）路由被废弃并返回 404，所有 Agent 路由统一到 /console/api/agent（单数）。如果前端 dev 环境仍在调用废弃的复数接口，就会持续出现 404。

环境排查

• 确认 Dify 后端版本是否为 1.16.0-rc1 或包含 PR #37465 的提交。
• 检查前端 API 调用代码中创建 Agent 的请求路径，是 /console/api/agents 还是 /console/api/agent。
• 确认本地前端源码是否已同步 main 分支最新代码，或是否存在构建缓存/热更新滞后。
• 检查 dev 模式下的前端代理配置，是否将 API 请求正确转发到后端服务。

解决步骤

1. 在前端代码中搜索 /agents 相关的 API 调用，定位创建 Agent 的请求路径。
2. 将路径改为单数形式 /agent，例如 POST /console/api/agent。
3. 如果本地代码已是最新但仍报错，尝试清除前端构建缓存（如 node_modules/.vite 或 dist 目录）后重新启动 dev server。
4. 确认后端路由定义（api/controllers/console/agent/roster.py 第 514-571 行）中已存在单数路由。
5. 若修改后仍存在 404，检查浏览器 Network 面板中实际请求的完整 URL，确认是否存在路径前缀或代理转发问题。

验证方法

在 dev mode 下重新执行创建 Agent 操作，观察是否不再出现 404 错误 toast，且浏览器 Network 面板中对应请求返回 200/201 状态码。

参考来源

langgenius/dify #38646

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。