JS文件加载失败主因是静态资源路径解析错误，需依次检查HTML中script标签路径、Web服务器文档根目录配置、使用PHP动态生成基础路径、验证文件权限与大小写一致性、禁用浏览器缓存。
如果您在本地部署 PHP 项目后发现 JS 文件无法加载，浏览器控制台提示 404 错误或 MIME 类型不匹配，则很可能是静态资源路径未正确解析。以下是排查与修正此问题的具体操作步骤：
一、检查 HTML 中 script 标签的 src 属性路径
静态资源加载失败常源于 HTML 中引用 JS 的路径为相对路径且未适配当前 URL 结构，导致浏览器拼接出错误的请求地址。
1、打开浏览器开发者工具，切换到 Network 标签页，刷新页面，定位到报错的 JS 文件请求。
2、查看该请求的 Initiator 列，点击对应 HTML 行，跳转至 script 标签所在位置。
立即学习“PHP免费学习笔记（深入）”；
3、确认 src 属性值是否以 / 开头（绝对路径） 或以 ./ 或 ../ 开头（相对路径）。
4、若为相对路径，检查当前 HTML 文件所在目录层级与 JS 文件实际存放位置是否匹配；若为绝对路径，确认其是否相对于 Web 根目录（如 localhost:8000/）而非文件系统根目录。
二、验证 Web 服务器文档根目录配置
PHP 本地环境（如 Apache、Nginx 或内置服务器）若未将项目入口目录设为文档根目录，会导致以 / 开头的路径指向错误位置。
1、若使用 PHP 内置服务器，执行命令时需明确指定路由文件并确保根目录正确：php -S localhost:8000 -t public/ public/index.php（假设静态资源在 public/ 下）。
2、若使用 Apache，检查 httpd.conf 或 .htaccess 中 DocumentRoot 是否指向项目中包含 assets/js/ 的目录（如 DocumentRoot "/path/to/project/public"）。
3、若使用 Nginx，检查 server 块中 root 指令是否设置为实际资源所在路径，例如：root /path/to/project/public;。
三、使用 PHP 动态生成基础路径避免硬编码
手动维护路径易出错，可通过 PHP 脚本动态输出符合当前部署结构的基础 URL，确保所有静态资源引用一致。
1、在项目公共配置文件或入口文件中定义常量：define('ASSET_BASE', '/assets/');（适用于根目录部署）。
2、若项目部署在子目录（如 localhost/myapp/），改用动态计算：define('ASSET_BASE', rtrim(dirname($_SERVER['SCRIPT_NAME']), '/').'/assets/');。
3、在 HTML 中调用该常量：<script src="= ASSET_BASE ?>js/main.js"></script>。
四、检查文件权限与大小写敏感性
本地开发环境（尤其是 macOS 或 Linux）对文件名大小写敏感，而 Windows 默认不敏感，可能导致路径看似正确但实际文件未被找到。
1、在浏览器 Network 面板中复制 JS 请求的完整 URL，粘贴至新标签页直接访问，观察是否返回 404 或 403。
2、通过终端进入项目静态资源目录，执行 ls -l assets/js/，确认目标 JS 文件名（如 main.js）与 HTML 中引用的完全一致（包括大小写）。
3、检查文件权限是否允许 Web 服务器用户读取，必要时执行：chmod 644 assets/js/*.js。
五、禁用浏览器缓存强制重载资源路径
浏览器可能缓存了旧版 HTML 或 304 响应，掩盖了路径修正后的实际效果，需排除缓存干扰。
1、在开发者工具 Network 面板勾选 Disable cache 选项。
2、使用快捷键组合强制刷新：Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）。
3、清除当前域名下的全部缓存：在 Application 标签页中选择 Clear storage → 勾选 Cached images and files → 点击 Clear site data。
