首先确认gd库已启用，检查php.ini配置并安装扩展；其次确保图像与水印文件路径正确且有读写权限；然后验证imagecreatefromxxx()是否成功创建资源，避免因格式问题导致加载失败；最后必须调用imagejpeg()输出或保存图像，并释放内存。按此流程逐步调试可解决php水印添加无效问题。
PHP调用图像水印添加函数无效，通常不是函数本身的问题，而是环境配置、参数传递或图像处理逻辑出现疏漏。下面从常见原因入手，结合图像处理流程，帮你快速定位并解决该问题。
检查GD库是否启用
PHP图像处理依赖GD扩展，若未开启，任何图像操作都会失败。
- 运行 phpinfo() 查看是否有GD库信息
- 在 php.ini 中确认 extension=gd 已取消注释
- Linux服务器可通过命令 sudo apt install php-gd 安装（根据PHP版本调整）
确认文件路径与权限正确
图像和水印文件路径错误或读写权限不足，会导致函数看似“无反应”。
- 使用绝对路径而非相对路径，避免因执行位置不同导致加载失败
- 确保PHP有权限读取原图和水印图，可临时设置权限为 644 测试
- 添加 file_exists() 判断文件是否存在
验证图像资源创建是否成功
imagecreatefromxxx() 函数在文件损坏或格式不支持时返回 false，但不会自动报错。
立即学习“PHP免费学习笔记（深入）”；
- 添加判断：if (!$src_img) { die('无法加载原图'); }
- 常见问题：PNG含透明通道未正确处理，JPG压缩异常
- 建议统一转换为标准格式测试，如将图片另存为标准JPG再试
水印叠加逻辑需手动输出或保存
很多开发者忽略了图像最终的输出步骤。
添加水印后必须显式输出或保存：
- header('Content-Type: image/jpeg'); 配合 imagejpeg($dst_img); 在浏览器显示
- 使用 imagejpeg($dst_img, 'path/to/watermarked.jpg', 90); 保存到服务器
- 处理完成后记得释放内存：imagedestroy($img);
完整示例代码参考
以下是一个稳定可用的水印添加片段：
$src_img = imagecreatefromjpeg('original.jpg');
$watermark = imagecreatefrompng('logo.png');
if (!$src_img || !$watermark) {
die('图像加载失败');
}
$w = imagesx($watermark);
$h = imagesy($watermark);
imagecopy($src_img, $watermark, 10, 10, 0, 0, $w, $h);
imagejpeg($src_img, 'output.jpg', 90);
imagedestroy($src_img);
imagedestroy($watermark);
基本上就这些。只要确保GD启用、路径正确、资源创建成功，并完成输出或保存，水印功能就能正常工作。调试时建议逐步打印中间状态，避免一步到位却无法定位问题。
