GD库合成海报失败主因是路径错误、alpha通道未启用、中文编码未转换及缓存策略不当；需用realpath()转绝对路径，调用imagealphablending()和imagesavealpha()开启透明支持，mb_convert_encoding()转GBK编码，缓存用内容哈希命名并本地存储。
GD库合成海报时图片资源加载失败
常见现象是生成的海报只有背景色、文字，水印图或头像没显示，甚至报 imagecreatefrompng(): failed to open stream。本质是路径没对上，GD不认相对路径或URL。
- 用
realpath()转成绝对路径再传给imagecreatefrompng()等函数，比如：realpath('./public/static/watermark.png') - 别直接用
$_SERVER['DOCUMENT_ROOT']拼接，ThinkPHP 的 public 目录位置可能被重定义，优先读配置里的root_path或用app()->getBasePath() . '../public/' - 如果水印图来自用户上传，确保文件存在且权限可读（
is_readable()先判断）
多层图像合成顺序和透明度控制不准
水印盖不住背景图、头像变黑块、文字边缘发虚——多半是没处理好 alpha 通道和绘制顺序。GD 默认关闭 alpha 合成，必须手动开。
- 在创建画布后立即调用
imagealphablending($img, true)和imagesavealpha($img, true) - 图层叠加按「从底到顶」顺序：先
imagecopyresampled()背景图，再贴头像，最后贴水印；文字用imagettftext()放最上层 - 水印 PNG 若自带透明度但显示为灰底，说明源图保存时用了“快速透明”（非 alpha），重导出为带完整 alpha 通道的 PNG
中文文字排版错位、乱码或截断
imagettftext() 写中文崩坏，不是字体问题就是编码/尺寸算错了。GD 不解析 UTF-8，得靠 PHP 把字符串转成 GBK 或直接用 mb_convert_encoding()。
- 字体文件必须是支持中文的 TTF（如 simhei.ttf、NotoSansCJK.ttc），且路径用
realpath()补全 - 写之前做转换：
$text_gbk = mb_convert_encoding($text, 'gb2312', 'utf-8')，再传给imagettftext() - 文字宽度不能靠
strlen()估算，要用imagettfbbox()测真实像素宽高，否则居中、换行都会偏 - 字号别硬写数字，根据画布宽度动态算，比如海报宽 750px，标题字号设
floor(750 / 20)
ThinkPHP 请求上下文里生成海报的性能与缓存陷阱
每次分享都实时生成，CPU 占满、响应慢；加缓存又容易失效或污染——关键在「何时生成」「存哪」「怎么取」。
立即学习“PHP免费学习笔记（深入）”；
- 不要在控制器里直接输出图片流（
header('Content-Type: image/png')），改用Response::create($content, 'image/png')返回，方便中间件拦截缓存 - 文件名别用时间戳，用内容哈希：把背景图路径、头像 URL、文案、字体、字号拼一起
md5()，生成唯一 key - 缓存建议存本地（
runtime/poster/），别依赖 Redis 存二进制大对象；同时加过期时间（如 24 小时），避免头像更新后海报不刷新
真正麻烦的是多尺寸适配和 retina 屏缩放——同一张海报要出 @1x/@2x 两版，imagecreatetruecolor() 宽高得翻倍，但 imagettftext() 字号和坐标也得同比例放大，这里漏掉一个系数，整张图就糊了。
