CPanel部署Laravel Filament时CSS/JS加载异常求助及部署资源推荐

一、CSS/JS路径错误的修复步骤 #

1. 修正APP_URL环境变量 #

打开项目根目录的.env文件，将APP_URL设置为你的站点根域名（不要带/admin后缀）：

APP_URL=https://example.com

这个配置决定了Laravel生成静态资源URL的基础路径，错误的APP_URL会导致Filament的CSS/JS路径多出来/admin。配置完成后执行缓存清除命令：

php artisan config:cache

2. 确认Filament路由前缀配置 #

config/filament.php中的path项是后台的访问路由前缀（比如https://example.com/admin），这个配置不会影响静态资源路径，保持默认的admin即可：

'path' => 'admin',

3. 检查CPanel站点根目录映射 #

在CPanel的「文件管理器」或「域名管理」中，确保Laravel项目的public文件夹被设置为站点的根目录：

• 若项目放在服务器的public_html目录下，站点根目录应指向public_html/public
• 不要将整个Laravel项目放在public_html/admin下，否则会导致静态资源路径嵌套错误。

4. 清除Laravel缓存 #

执行以下命令清除路由、视图缓存，确保新配置生效：

php artisan route:cache
php artisan view:cache

二、Laravel生产部署优质资源推荐 #

• Laravel官方部署文档：权威入门指南，覆盖环境要求、缓存优化、队列配置、安全加固等核心部署环节。
• Laracasts部署系列教程：视频形式演示从本地到生产环境的完整流程，包含CPanel、VPS等不同环境的实操细节。
• 《Laravel实战》书籍部署章节：深入讲解生产环境的Nginx配置、SSL证书安装、PHP版本优化、性能调优等内容。
• Laravel Forge官方文档：针对VPS服务器的一键部署工具，文档涵盖服务器监控、环境配置、自动化部署等实用内容。
• Laravel News部署专题：社区定期更新的部署最佳实践，包含最新的PHP版本选择、缓存策略、安全防护等行业动态。

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