Web服务器配置错误是静态资源404主因，需确保document_root指向public目录，PHP内置服务器需路由脚本中用return false触发静态文件服务，HTML应使用绝对路径并排查缓存与重定向干扰。
确认 document_root 和请求路径是否匹配
PHP 本身不处理静态资源，404 实际由 Web 服务器（Nginx/Apache）返回。最常见原因是 Web 服务器配置的 document_root 指向了错误目录，比如指向了项目根目录，但 HTML 中写的 src="/assets/js/app.js" 却期望文件在 public/assets/js/app.js 下。
检查方式：打开浏览器开发者工具 → Network 标签 → 点击 404 的资源链接 → 看 Request URL 是什么，再对照服务器上真实文件路径。例如请求的是 http://localhost/assets/js/app.js，而你实际文件在 /var/www/myapp/public/assets/js/app.js，那就说明 Web 服务器没把 /public 设为根目录。
- Nginx 需确保
root指令指向public/目录（不是项目根目录） - Apache 需确认
DocumentRoot指向public/，且.htaccess在该目录下生效 - 本地用
php -S测试时，必须显式指定路由脚本并重写静态请求，否则默认不服务子路径资源
php -S 内置服务器下静态资源 404 怎么办
PHP 内置服务器不会自动提供静态文件，所有请求都交给路由脚本（如 router.php），若脚本里没手动读取并输出静态文件，就必然 404。
解决办法是在路由脚本中拦截静态路径，用 file_exists() 判断并输出：
立即学习“PHP免费学习笔记（深入）”；
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|woff2|ttf)$/', $_SERVER["REQUEST_URI"])) {
return false; // 告诉内置服务器：请直接 serve 这个文件
}
// 否则走 PHP 路由逻辑
include __DIR__ . '/index.php';
注意：return false 是关键，它触发内置服务器回退到文件系统查找；如果写成 readfile() + exit，需手动设置 Content-Type，否则 CSS/JS 可能被当成 text/html 解析。
HTML 中路径写法导致 404 的典型陷阱
相对路径（如 src="js/app.js"）依赖当前 HTML 所在 URL 路径，极易出错。比如访问 /admin/user/edit 时，浏览器会尝试加载 /admin/user/js/app.js，而不是你想要的 /js/app.js。
- 优先用绝对路径：以
/开头，如src="/js/app.js"，表示从域名根开始找 - 避免
./或../—— 它们在不同路由深度下行为不可控 - 如果项目部署在子目录（如
https://example.com/myapp/），需统一加前缀：src="= $base_url ?>/js/app.js" - 检查浏览器 Network 面板里请求的完整 URL，和你预期的是否一致——这是最快定位路径问题的方式
缓存和重定向干扰导致“明明改对了还 404”
改完配置或路径后仍 404，大概率是浏览器或代理缓存了旧的 404 响应（HTTP 状态码也会被缓存），或服务器返回了 301 重定向却没更新目标地址。
- 强制刷新：Ctrl+F5（Windows）或 Cmd+Shift+R（macOS）绕过内存缓存
- 在 Network 面板勾选 “Disable cache” 再试
- 检查响应头里是否有
Location字段，确认是否被意外重定向到了错误路径 - Nginx/Apache 日志里搜对应 URI，看 access log 是否真收到了请求、error log 有没有提示文件不存在或权限拒绝
路径问题本身不难，难的是你以为改的是 PHP，其实得调 Web 服务器；你以为清了浏览器缓存，其实 CDN 或反向代理还在吐旧响应。
