框架部署后首页正常但路由 404

故障现象或目标

静态文件和首页正常，其他应用路由失败。

原因与定位

运行目录或前端控制器转发规则未与框架匹配。

nginx -t
curl -I https://example.com/<已知应用路由>

处理方案

核对站点根目录是否应指向 public，按框架文档配置前端控制器转发。不要用任意文件存在检查吞掉真实静态资源或错误页。

验证与回退

已知路由、静态文件和不存在的地址都返回预期结果。

修改前保留配置与程序版本。验证不通过时恢复本次文件或上一个发布版本，再检查服务状态与访问日志。