Inertia.js部署服务器后部分组件仅可通过<LINK>访问，直接访问报500错误

1. 检查服务器路由重写配置 #

Inertia依赖前端路由逻辑，服务器必须将所有非静态资源的请求转发至应用入口文件（比如Laravel的public/index.php、Node项目的服务入口）。直接访问链接时，若服务器找不到对应物理文件且未配置重写规则，就会触发500错误：

• Nginx：在server配置块中添加try_files $uri $uri/ /index.php?$query_string;
• Apache：启用mod_rewrite模块，确保项目根目录的.htaccess包含正确的重写规则（如Laravel默认的RewriteRule配置）

2. 核对环境变量配置 #

本地与服务器的环境变量不一致，会导致服务端渲染或资源加载失败：

• 检查服务器.env文件，确认APP_URL设置为服务器的公网域名（而非本地地址）
• 将APP_ENV设为production，执行配置缓存命令（如Laravel的php artisan config:cache）清除旧配置缓存

3. 排查服务端渲染(SSR)问题 #

若启用了SSR，服务器上的SSR服务异常会直接引发500错误：

• 确认SSR进程已启动且正常运行（可通过pm2 list等进程管理工具查看）
• 检查服务器是否安装了所有依赖（执行npm install），并重新编译SSR资源（npm run build:ssr）
• 查看SSR服务的日志文件，定位具体报错信息

4. 修复目录权限问题 #

服务器上存储、缓存目录权限不足，会导致Inertia写入数据失败：

• 给应用的storage、bootstrap/cache（Laravel项目）目录设置正确权限：chmod -R 755 storage bootstrap/cache
• 将目录所属用户调整为web服务器运行用户（如chown -R www-data:www-data storage）

5. 查看服务器错误日志 #

浏览器无提示时，服务器日志是定位问题的核心依据：

• Laravel项目查看storage/logs/laravel.log
• Nginx/Apache查看对应站点的error.log文件
• 根据日志中的错误栈信息，精准定位代码或配置问题

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