Debian系统里跑PHP，日志文件（Apache下是/var/log/apache2/error.log，Nginx下是/var/log/nginx/error.log）可以说是排查问题的第一现场。里面那些警告信息，其实主要就分两大类：PHP内置的错误级别警告，以及开发者自己搞的用户自定义警告。下面咱们就掰开揉碎，看看最常见的那些“坑”长什么样。
一、内置错误级别警告
1. E_WARNING（非致命运行时错误）
这玩意儿不会让脚本当场挂掉，但会提示代码里藏着隐患。常见场景包括：
- 用
include('missing_file.php')引了个不存在的文件； - 直接
echo $undefined_var，变量连定义都没定义； - 干了
$result = 10 / 0这种除零操作； - 调用
file_get_contents('/nonexistent/path.txt')打开一个不存在的文件。
解决方法其实不复杂：检查文件路径、初始化变量、在除法前加个除数判断，基本就能搞定。
2. E_NOTICE（运行时注意事项）
这类警告不耽误执行，但说明代码写得不够规范，属于“可以但没必要”的隐患。常见场景：
- 直接输出未初始化变量，比如
echo $uninitialized_var； - 访问数组里不存在的键，比如
echo $array['nonexistent_key']； - 字符串偏移量越界，比如
$str长度只有5，却去取$str[10]。
解决方法也很干脆：用isset()、empty()或array_key_exists()先检查一下变量或键是否存在，再动手。
3. E_DEPRECATED（已弃用特性警告）
这个警告的意思是：你用的某个函数或特性，在未来的PHP版本里会被移除，赶紧升级代码吧。常见场景：
- 还在用老掉牙的
mysql_connect()，而不是mysqli_connect()； - 调用了某个旧版PDO类里的过时方法。
应对方法：去PHP官网查文档，把那些被标为“deprecated”的函数替换成推荐的新版本，比如mysqli_*系列。
4. E_STRICT（严格标准警告）
这个警告专门用来提示代码不符合PHP的严格编码标准，可能影响跨版本兼容性。常见场景：
- 用旧版的
__autoload()来做类自动加载； - 函数声明了
function foo(int $param)，但实际传了个字符串进去。
解决办法：遵循PHP的最佳实践，调整代码结构或参数类型，让代码更规范。
5. E_USER_* 系列（用户自定义警告）
这类警告是开发者自己通过trigger_error()函数主动触发的，用于自定义错误处理。常见场景：
- 业务逻辑验证失败，比如输入不合法，就触发
trigger_error('Invalid user input', E_USER_WARNING)； - 在特定条件下提醒，比如库存不足时触发
E_USER_NOTICE。
解决方法：检查trigger_error()的调用逻辑，确认触发条件是否合理，或者是否需要调整触发时机。
二、常见具体警告示例及解决
1. 未定义变量
- 日志信息：
Warning: Undefined variable $username in /var/www/html/login.php on line 10 - 原因：变量
$username还没初始化就直接拿来用了。 - 解决：用
isset()检查一下，或者先初始化，比如$username = isset($_POST['username']) ? $_POST['username'] : '';
2. 数组键不存在
- 日志信息：
Warning: Undefined index 'email' in /var/www/html/profile.php on line 15 - 原因：去访问
$_SESSION['email']，但email这个键压根不存在。 - 解决：用
isset($_SESSION['email'])或array_key_exists('email', $_SESSION)先确认一下。
3. 文件未找到
- 日志信息：
Warning: file_get_contents(/var/www/html/config.json): failed to open stream: No such file or directory in /var/www/html/init.php on line 5 - 原因：文件路径写错了，或者文件真的不存在。
- 解决：检查文件路径是否正确，确保文件存在且路径可访问。
4. 除零错误
- 日志信息：
Warning: Division by zero in /var/www/html/calculate.php on line 20 - 原因：数学运算里除数为零，比如
$result = $total / 0。 - 解决：加个除数判断，
if ($divisor != 0) { $result = $total / $divisor; }。
5. 会话启动失败
- 日志信息：
Warning: session_start(): Cannot start session when headers already sent in /var/www/html/index.php on line 2 - 原因：在调用
session_start()之前，已经往页面输出了内容（可能是空格、HTML标签或echo语句）。 - 解决：确保
session_start()在脚本最顶部调用，或者在前面用ob_start()开启输出缓冲。
以上就是Debian PHP日志里最常见的警告类型汇总。拿到日志后，注意看文件名、行号和错误描述，基本就能快速定位到问题，然后对症下药。这些经验，都是实战中一点一点攒出来的，希望对你有帮助。
