Laravel共享主机部署UI错乱问题求助（Jetstream认证）

1. 核对静态资源路径配置 #

• 确认.env文件里的APP_URL和你的域名完全匹配（比如https://yourdomain.com，不要加结尾斜杠）
• 检查config/app.php中的asset_url配置，若共享主机有特殊静态资源路径，需在此指定；如果public_html是根目录，通常无需额外设置

2. 确认build产物上传完整 #

• 本地执行npm run build后，public/build目录会生成编译后的JS、CSS及资源文件，务必将这个目录完整上传到共享主机的public_html/build目录下
• 检查这些文件的权限，确保服务器可读取（一般设置目录权限为755，文件权限为644）

3. 清理各类缓存 #

• 若服务器有SSH权限，执行以下Laravel缓存清理命令：

  php artisan config:clear
  php artisan cache:clear
  php artisan view:clear
  

• 无SSH权限的话，可临时在路由中添加清理代码（用完记得删除）：

  Route::get('/clear-cache', function() {
      Artisan::call('config:clear');
      Artisan::call('cache:clear');
      Artisan::call('view:clear');
      return 'Cache cleared';
  });
  

4. 检查Tailwind CSS配置（Jetstream默认依赖） #

• 确认tailwind.config.js的content配置包含所有需要扫描的文件路径，比如：

  content: [
      "./resources/**/*.blade.php",
      "./resources/**/*.js",
      "./resources/**/*.vue",
      "./vendor/laravel/jetstream/**/*.blade.php",
  ],
  

  本地build时路径正确的前提下，要确保这些文件都已上传到服务器对应位置
• 若有自定义Tailwind配置（比如主题色、间距），确认build时已正确编译

5. 验证服务器环境兼容性 #

• 检查服务器PHP版本是否符合Laravel和Jetstream的要求（例如Laravel 10要求PHP 8.1及以上）
• 确认服务器开启了fileinfo扩展，这是处理静态资源的必要扩展

6. 查看浏览器控制台错误 #

• 打开浏览器开发者工具（F12），切换到Console和Network标签：
  • Console若出现404错误，说明静态资源路径错误，找不到对应CSS/JS文件
  • Network标签查看资源请求URL是否正确，比如是否指向了错误的域名或路径

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