[Question] 404 NOT Found

[xiaomeng3419]

描述问题
清晰而简洁地描述你遇到的问题

复现
重现该行为的步骤:

1. 本地源码编译运行 3.1.9.1版本
2. 登录管理员
3. 点击我的工单，首页
4. 首页用户无反应，列表404

期望的结果

截图

部署方式

• Docker
• [✅] Manual

环境 (请填写环境信息):

• 操作系统: [e.g. iOS]
• 浏览器 [e.g. chrome, safari]
• 版本号 [e.g. 22]

额外的日志信息
在这里添加有关该问题的所有日志。

[Issues-translate-bot]

Bot detected the issue body's language is not English, translate it automatically. 👯👭🏻🧑‍🤝‍🧑👫🧑🏿‍🤝‍🧑🏻👩🏾‍🤝‍👨🏿👬🏿

---

Describe the problem
Clearly and concisely describe the problem you encountered

Recurrence
Steps to reproduce the behavior:

1. Compile and run the local source code 3.1.9.1 version
2. Log in as administrator
3. Click on My Work Order, Home Page
4. No response from users on the homepage, list 404

Desired results

Screenshot

Deployment method

• Docker
• [✅] Manual

Environment (please fill in environmental information):

• Operating system: [e.g. iOS]
• Browser [e.g. chrome, safari]
• version number [e.g. 22]

Additional log information
Add all logs about the issue here.

[dosubot]

Hi @xiaomeng3419! I'm Dosu and I’m helping the Yearning team.

你遇到的 404 问题很可能是由于前端请求的接口路径与后端实际暴露的接口不一致，或者手动部署时配置有误导致。Yearning 3.1.9.1 的“我的工单”功能是通过 WebSocket 连接 /api/v2/common/list 获取数据，首页则依赖 /api/v2/dash/banner 和 /api/v2/dash/top 等接口。如果前端请求的路径不是 /api/v2 开头，或者后端没有正确启动/配置这些接口，就会出现 404。

建议你：

1. 检查 conf.toml 配置，尤其是 SecretKey 必须为 16 位，不能多也不能少，否则会导致各种异常（如 404、500 等）参考。
2. 用浏览器开发者工具查看网络请求，确认前端请求的接口路径是否为 /api/v2/xxx，且没有跨域或路径错误。
3. 确认前后端的 API 地址、端口、版本号完全一致，且后端服务已正常启动并监听对应端口。
4. 查看后端日志，定位 404 发生时是否有相关报错或警告信息。
5. “我的工单”必须用 WebSocket 方式访问 /api/v2/common/list，不能用普通 HTTP 请求，否则会 404 代码参考。

如果以上都没问题，建议清理前后端编译缓存，重新编译并启动服务，排除版本或缓存不一致导致的接口缺失。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}