宝塔PHP网站500错误优先查error.log日志，定位PHP Fatal/Parse error或内存耗尽提示；若日志为空则检查PHP扩展（如mbstring、openssl）是否启用、opcache是否干扰、display_errors是否关闭；再验证代码语法、PHP版本兼容性及配置参数一致性。
宝塔面板里 PHP 网站返回 500 错误，不是配置崩了就是代码挂了——先别急着重装，90% 的情况能靠日志和错误定位快速解决。
看宝塔自带的网站错误日志 error.log
这是最直接的入口。在宝塔面板 → 网站 → 对应站点 → 日志 → 错误日志，打开最新 error.log 文件。
- 重点找带
PHP Fatal error、PHP Parse error、Allowed memory size exhausted的行，它们会明确指出哪一行、哪个函数出的问题 - 如果日志为空或只有
Premature end of script headers，说明 PHP 进程根本没跑起来，大概率是 PHP 配置或扩展问题 - 注意时间戳是否和你访问 500 页面的时间吻合，避免被旧日志干扰
确认 PHP 版本与扩展是否匹配
很多 500 是因为扩展没装对或版本冲突。比如 Laravel 10 要求 mbstring 和 openssl 启用，但宝塔默认可能没开；又或者升级 PHP 后忘了重新编译 redis 扩展。
- 进宝塔 → 软件商店 → PHP 对应版本 → 设置 → 安装扩展，勾选
mbstring、curl、openssl、pdo_mysql等基础项 - 执行
php -m（在 SSH 中切换到对应 PHP 版本 bin 目录下运行）核对已启用模块，对比报错项目文档的依赖要求 - 如果启用了
opcache，且改完代码仍 500，试试临时关闭它：编辑/www/server/php/{版本}/etc/php.ini，把opcache.enable=1改成0，然后重启 PHP
开启 PHP 的详细错误提示（仅限测试环境）
线上环境默认关闭错误显示，导致只看到 500 而无具体信息。临时开启可快速暴露问题根源。
立即学习“PHP免费学习笔记（深入）”；
- 修改网站根目录下的
.user.ini（宝塔默认生成），把display_errors = Off改成On；同时确保error_reporting = E_ALL - 如果用了
php.ini独立配置，检查fastcgi_param PHP_VALUE是否覆盖了这些设置（常见于 Nginx 配置中） - 改完必须重启 PHP 服务，否则不生效；切记上线前关掉，避免泄露路径或敏感信息
检查用户代码里的致命语法或运行时异常
日志里没线索？可能是代码里藏着未捕获的异常，比如调用了一个不存在的方法、include 了错误路径、或用了高版本 PHP 特性但服务器版本偏低。
- 用
php -l index.php检查入口文件语法（替换为你的实际入口），快速发现Parse error - 查看最近修改的文件，特别是控制器、配置文件、
composer.json升级后新增的类 —— 常见坑：str_contains()在 PHP 7.4 以下不可用，match表达式只支持 8.0+ - 如果用了 Composer 自动加载，执行
composer dump-autoload（在网站根目录），防止类找不到导致Fatal error: Class 'xxx' not found
真正难搞的 500 往往藏在“看起来没问题”的地方：比如 .env 文件权限是 777、upload_max_filesize 和 post_max_size 不一致、甚至某个自定义函数名和内置函数冲突。日志是起点，但得带着上下文去读——而不是只扫一眼错误类型就去百度搜解决方案。
