Laravel 8项目引入CSS/JS文件返回404错误该如何解决？

问题根因 #

你当前的配置和路径生成逻辑存在3个核心异常点：

1. 错误配置ASSET_URL=public，会让asset()函数自动在资源路径前拼接多余的public前缀
2. 最终生成的资源路径多了项目目录名MyProject，无法匹配public目录下的真实资源地址
3. 额外校验：你代码中引入的css文件路径写的是assets/js/目录，请先确认css文件确实存放在js目录而非专门的css目录，避免低级路径拼写错误。

修复步骤 #

• 第一步：修正.env配置 #

  首先删除.env中你新增的ASSET_URL=public行，再根据你使用的服务启动方式选择对应配置：
  • 若使用php artisan serve启动本地服务：不需要额外配置ASSET_URL参数
  • 若直接通过Xampp访问localhost/MyProject/public：添加配置ASSET_URL=http://localhost/MyProject/public

• 第二步：清理配置缓存 #

  开发阶段不要使用config:cache命令，会导致配置无法实时生效，执行以下命令清理缓存即可：

  php artisan config:clear
  php artisan cache:clear
  

• 第三步：验证资源路径 #

  重启服务后刷新页面，检查资源地址是否符合预期：
  • 用artisan serve启动的场景，资源地址应为http://127.0.0.1:8000/assets/js/countdown-home.js
  • 用Xampp直接访问的场景，资源地址应为http://localhost/MyProject/public/assets/js/countdown-home.js

长期优化建议 #

如果经常用Xampp运行该项目，建议配置虚拟主机，将虚拟主机的根目录直接指向MyProject/public，设置本地hosts映射自定义域名（比如myproject.test），即可彻底避免路径前缀问题，也更接近线上生产环境的运行逻辑。

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