GD函数默认不抛异常，只返回false或触发E_WARNING；需主动检查返回值、用set_error_handler将警告转为异常、预验证图像文件并屏蔽敏感错误信息。
PHP 图像处理错误不能靠 try-catch 自动捕获——GD 函数默认不抛异常，只返回 false 或触发 E_WARNING。想做到“出错不崩、提示友好、日志可查”，必须主动干预。
GD函数失败不抛异常，只返回false或警告
这是最常被忽略的前提。像 imagecreatefromjpeg()、imagecopyresampled()、imagejpeg() 这类函数，在文件损坏、格式不支持、内存不足时，一律返回 false，不会自动变成 Exception。直接写 try { $img = imagecreatefromjpeg(...); } 然后指望 catch 捕到，根本不会进 catch 块。
- 必须显式检查返回值：
if (!$img) { /* 处理失败 */ } - 警告（
E_WARNING）默认输出到页面或日志，但不中断执行，也不进入异常流 -
@抑制警告只是掩盖问题，不是解决——它让错误静默消失，反而更难定位
用set_error_handler临时捕获GD警告并转为异常
把 GD 触发的 E_WARNING 转成可捕获的 Exception，是让图像处理接入统一异常体系的关键一步。但要注意作用域和恢复时机，否则会影响其他模块。
- 在调用 GD 函数前，用
set_error_handler()注册一个只处理E_WARNING的回调 - 回调里手动
throw new Exception()，这样就能被外层try-catch捕获 - 必须在
finally里调用restore_error_handler()，否则后续代码可能意外被这个处理器干扰 - 不要全局长期启用该处理器——仅包裹具体 GD 操作段，避免副作用
示例：
立即学习“PHP免费学习笔记（深入）”；
function gd_warning_to_exception($errno, $errstr) {
throw new Exception("GD warning: $errstr", $errno);
}
<p>set_error_handler('gd_warning_to_exception', E_WARNING);
try {
$img = @imagecreatefrompng('corrupt.png');
if (!$img) {
throw new Exception('PNG 解析失败：文件损坏或不支持');
}
// ... 后续处理
} catch (Exception $e) {
error_log('[GD] ' . $e->getMessage());
echo '图片处理失败，请检查文件格式';
} finally {
restore_error_handler();
}预验证图像文件再交给GD处理
很多 GD 错误其实可以前置拦截——比如传入空文件、非图像 MIME 类型、超大尺寸，完全没必要等 GD 加载失败才反应。提前验证能减少 GD 层面的失败率，也让提示更精准。
- 用
getimagesize($file)判断是否为有效图像，它返回数组则表示成功，false表示无效 - 配合
finfo_open(FILEINFO_MIME_TYPE)检查真实 MIME 类型，防止伪造后缀（如 .jpg 实际是 HTML） - 检查文件大小是否超过
upload_max_filesize或 GD 内存限制（memory_limit） - 对用户提示要区分场景：“文件不是图片”比“系统错误”更明确，“图片过大”比“处理失败”更可操作
生产环境必须屏蔽GD原始错误信息
GD 报错里常含绝对路径、服务器配置、内存使用量等敏感信息。一旦直接输出到前端，等于给攻击者递地图。开发时可看，上线后必须过滤。
- 禁用
display_errors（php.ini 或运行时ini_set('display_errors', 0)） - 所有面向用户的提示统一走业务语言，如“图片格式不支持”“图片已损坏”，不出现
imagecreatefromjpeg(): gd-jpeg: JPEG library reports unrecoverable error - 日志中保留完整错误上下文（含
$e->getTraceAsString()），但绝不暴露给浏览器 - 若用
set_exception_handler兜底，确保它不把$e->getMessage()直接 echo 出来
真正容易被忽略的，是 GD 错误的“双重身份”：它既是底层资源操作失败，又是用户上传内容质量的问题。处理逻辑得兼顾技术兜底和体验引导——比如加载失败时，除了记录日志，还应考虑 fallback 图片或灰度占位，而不是留白或报错弹窗。
