Laravel应用部署至AWS后CSS/JS静态资源报404错误如何解决

该问题在cPanel环境运行正常、AWS环境异常，核心原因基本都是AWS环境默认配置和cPanel自带的Laravel适配配置不一致，按以下优先级排查即可：

1. 优先排查站点根目录指向错误 #

cPanel部署Laravel时一般会自动把域名根目录指向项目的public文件夹，但AWS所有部署场景（EC2自建web服务、Elastic Beanstalk、LightSail）都需要手动配置根目录，这是该问题最高发诱因。

• 验证方式：直接访问https://你的域名/public/assets/css/style.css，如果能正常加载样式文件，即可确认是根目录配置错误
• 修复方式：
  • Nginx环境：修改站点虚拟主机配置，将root字段值改为项目下的public绝对路径，示例：root /var/www/your-laravel-project/public;，修改后执行nginx -t验证配置无错，再执行nginx -s reload重载配置生效
  • Apache环境：将虚拟主机的DocumentRoot指向项目public目录，同时确认public/.htaccess文件完整上传（Laravel框架默认自带该文件，部署漏传会导致路径重写失效）
  • Elastic Beanstalk环境：在项目根目录新增.ebextensions配置项，指定站点根目录为public，避免默认指向项目根目录

2. 排查public目录权限配置错误 #

cPanel默认会给站点目录配置web服务用户的读权限，但AWS手动部署时如果权限配置不当，web服务进程没有静态文件的读权限，也会返回404。
执行以下命令修正权限（注意替换为你自己的项目路径、对应web服务用户名）：

# 进入项目根目录
cd /var/www/your-laravel-project
# 统一设置文件权限为644、目录权限为755
find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;
# 给web服务用户分配public目录所有权，Nginx在Ubuntu/Debian下默认用户为www-data，CentOS下为nginx，Apache默认用户为apache/www-data
chown -R www-data:www-data public/

注意：不要为了省事给目录设置777权限，会引发严重安全风险

3. 优化静态资源引用语法 #

你当前使用的url()辅助函数虽然可以生成路径，但对HTTPS、子目录部署的适配性不如Laravel官方推荐的asset()函数，AWS环境如果配置了SSL证书，很容易因为混合协议、路径前缀问题导致资源加载失败。
将模板中的静态资源引入代码替换为以下写法：

<link href="{{ asset('assets/css/style.css') }}" rel="stylesheet" />
<link href="{{ asset('assets/css/dark-style.css') }}" rel="stylesheet" />
<link href="{{ asset('assets/css/transparent-style.css') }}" rel="stylesheet">
<link href="{{ asset('assets/css/skin-modes.css') }}" rel="stylesheet" />

如果项目部署在域名的子路径下，记得修改config/app.php中的asset_url配置项，填写正确的子路径前缀，避免路径生成错误。

4. 排查缓存、路由、CDN拦截问题 #

• 如果你给站点配了AWS CloudFront CDN，检查CDN缓存规则，确认assets/*路径的请求不会被转发到Laravel路由层，而是直接读取public目录下的静态文件，修改规则后清空CDN缓存
• 检查routes/web.php中的路由配置，确认没有写优先级过高的通配路由拦截了assets/*开头的静态资源请求
• 执行Laravel缓存清理命令，清除旧配置缓存避免干扰路径生成：

php artisan config:clear
php artisan route:clear
php artisan view:clear

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