本地运行Rust Playground失败，访问127.0.0.1:5000返回404求助

排查方向1：前端构建是否完整且路径正确 #

• 确认在ui/frontend目录执行yarn后，是否生成了dist或类似的前端构建产物目录。部分项目需要明确执行yarn build完成构建，官方文档可能简化了描述，建议补执行一次yarn build验证。
• 检查ui服务代码里的静态文件配置，确认静态资源读取路径指向了前端构建后的目录（比如frontend/dist），路径错误会导致服务无法找到页面文件。

排查方向2：查看服务启动的完整日志 #

• 重新启动服务，留意Running target/debug/ui之后的输出，是否有端口绑定成功的提示（如Listening on 127.0.0.1:5000），或是加载静态文件失败的报错。如果日志仅停留在编译完成，可能存在静默启动失败的情况。

排查方向3：确认端口未被占用 #

• 执行命令检查5000端口是否被其他进程占用：

  lsof -i :5000  # macOS/Linux环境
  netstat -ano | findstr :5000  # Windows环境
  

  若端口被占用，可杀掉对应进程，或修改Rust Playground配置换用其他端口启动。

排查方向4：验证服务端路由配置 #

• 查看ui服务的路由代码，确认根路径/是否有对应的页面返回逻辑。如果是单页应用，需要配置服务端fallback路由，将所有非API请求转发到前端的index.html，否则会出现路由匹配失败的404。

额外验证步骤 #

• 尝试直接访问静态文件路径，比如127.0.0.1:5000/index.html：如果能正常访问，说明静态服务正常，问题出在根路由配置；如果仍返回404，说明静态文件未被服务正确加载。

内容的提问来源于stack exchange，提问作者0xsegfault