常见报错

一、500 Server Error

先看日志：

tail -50 storage/logs/laravel.log

常见原因：

| 日志关键字 | 原因 | 解决 | |---|---|---| | Permission denied | 目录权限 | chown -R www:www storage bootstrap/cache | | No application encryption key | 缺 APP_KEY | php artisan key:generate | | Connection refused | 数据库连不上 | 检查 .env 的 DB 配置 | | ionCube | 没装 Loader | 装 ionCube 扩展 | | Class not found | 依赖缺失 | composer install |

二、403 Forbidden

运行目录没设成 /public
Nginx 伪静态没配
.env 里 APP_URL 和实际域名不一致

三、404 Not Found

伪静态没配（所有路由都 404）
访问的路径确实不存在

四、白屏

PHP 错误但 display_errors 关了
查 storage/logs/laravel.log
临时开 APP_DEBUG=true 看报错

五、502 Bad Gateway

PHP-FPM 挂了或超时：

# 重启 PHP
/etc/init.d/php-fpm-82 restart

六、数据库相关

| 报错 | 解决 | |---|---| | 1045 Access denied | 用户名/密码错 | | 1049 Unknown database | 库不存在 | | 1146 Table doesn't exist | 没导入 SQL | | Specified key was too long | MySQL 版本低 |

七、图片/文件上传失败

upload_max_filesize 太小（php.ini 改大）
post_max_size 太小
storage 目录不可写
没执行 php artisan storage:link

八、定时任务不跑

# 手动跑看报错
cd /www/wwwroot/你的域名 && php artisan schedule:run

# 看队列
php artisan queue:work --stop-when-empty

九、AI 相关

| 报错 | 原因 | |---|---| | 401 | API Key 错 | | 402 | 余额不足 | | timeout | 服务器访问不了 AI API | | rate limit | 调用太频繁 |

十、支付相关

| 现象 | 原因 | |---|---| | 支付后订单不变 | 回调地址不通 | | 退款失败 | 证书/密钥错 | | 金额差 100 倍 | 单位搞错（分 vs 元） |

十一、获取技术支持

提供以下信息，能加快排查：

报错截图
storage/logs/laravel.log 相关片段
复现步骤
系统版本号（后台右下角）

下一篇：权限与文件问题