PHP require无报错不生效且后续代码不执行该如何调试？

AI 小北

2026-10-4

PHP require 无报错不执行问题调试方案

前置校验

你当前代码的错误输出配置存在疏漏，先替换开头的错误配置为全量报错模式：

error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
ob_end_flush(); // 关闭输出缓冲，避免内容被缓冲隐藏

分步调试步骤

第一步：排查权限问题
file_exists仅判断文件是否存在，不验证读取权限。先测试文件是否可读：
```
var_dump(is_readable("/home/path/to/file/file.php"));
```
同时校验Linux父目录权限：要访问目录内的文件，所有上级目录需要给PHP运行用户（通常为www-data、apache）开放执行权限（x权限），文件本身需要开放读权限（r权限）。
第二步：排查语法错误与文件内终止逻辑
先单独校验目标文件语法合法性，在服务器命令行执行：
```
php -l /home/path/to/file/file.php
```
如语法无报错，检查目标文件内是否存在exit、die等强制终止执行的语句，或者header("Location: xxx");后直接终止的跳转逻辑。
第三步：排查PHP配置拦截
首先检查open_basedir限制，该配置会限制PHP可访问的目录范围，即使文件存在也会被拦截：
```
var_dump(ini_get('open_basedir'));
```
确认目标文件路径在open_basedir的允许列表内。
其次查看PHP错误日志，默认日志路径可通过phpinfo()的error_log字段查看，常见路径为/var/log/php-fpm/error.log、站点对应的Nginx/Apache错误日志，运行脚本后查看日志内是否有隐藏的报错信息。
第四步：排查缓存干扰
如开启了Opcache缓存，可能存在旧缓存导致文件读取异常，在代码开头添加以下语句清空缓存测试：
```
opcache_reset();
```
也可以直接重启PHP-FPM/Apache服务清空所有缓存。
第五步：CLI模式单独测试
避免Web服务的配置干扰，在命令行直接执行入口脚本：
```
php /path/to/your/entry/script.php
```
CLI模式默认配置会展示更多报错信息，可直接定位问题。