水印位置不能写死坐标，因固定xy易遮挡主体；ThinkPHP的water()不支持随机偏移，需用getimagesize()获取原图尺寸，再以mt_rand()计算安全范围内的x、y坐标，并注意TP6与TP5.1参数顺序差异及水印文件校验。
水印位置偏移为什么不能直接写死坐标
因为固定 x、y 值会导致水印总出现在图片同一区域，比如右下角被文字遮挡、头像类图片主体在右侧时水印盖住关键内容。ThinkPHP 的 water() 方法本身不支持「随机偏移」参数，得自己算坐标再传进去。
用 getimagesize() 获取原图尺寸再计算随机范围
ThinkPHP 的水印逻辑依赖 GD 库，但 water() 接口只接收具体像素值，所以必须先读取原图宽高，再按比例生成安全偏移区间：
- 用
getimagesize($imagePath)拿到[0]（宽）和[1]（高） - 水印图自身尺寸需提前知道（比如 120×40），否则随机出界会触发 GD 警告或裁剪异常
- 推荐偏移范围：x ∈ [50, 原图宽 − 水印宽 − 50]，y ∈ [50, 原图高 − 水印高 − 50]，留出边缘余量
- 用
mt_rand()生成整数，避免rand()在高并发下重复率高
list($srcW, $srcH) = getimagesize($imagePath); $markW = 120; $markH = 40; $x = mt_rand(50, $srcW - $markW - 50); $y = mt_rand(50, $srcH - $markH - 50); $image->water($waterPath, $x, $y);
ThinkPHP 6.x 中 water() 的第三个参数是位置模式，不是坐标
很多人卡在这里：把 water($path, $x, $y) 当成「绝对坐标」用，结果发现 $x 和 $y 被忽略——因为 ThinkPHP 6 默认第三个参数是位置常量（如 Image::WATER_SOUTHEAST），只有传入第四个参数 null 才启用自定义坐标：
- 错误写法：
$image->water($mark, $x, $y)→ 实际走的是位置模式，$x被当成了模式值 - 正确写法：
$image->water($mark, null, null, $x, $y)，其中第2、3个null表示不使用预设位置和透明度，第4、5才是 x/y - TP5.1 则是
$image->water($mark, $x, $y, 100)，顺序不同，注意版本
高频报错 Warning: imagecopy(): supplied argument is not a valid Image resource
这个错误往往不是坐标问题，而是水印图路径无效或格式不支持（比如 WebP 水印在旧 GD 版本中无法加载），导致 $image->water() 内部调用失败后继续执行，最终 GD 函数收到空资源：
立即学习“PHP免费学习笔记（深入）”；
- 务必用
is_file($waterPath) && getimagesize($waterPath)提前校验水印文件可读且能解析 - 避免用相对路径（如
./public/static/water.png），统一用__DIR__ . '/../public/static/water.png'或app()->getRuntimePath() . '../public/...' - GD 不支持 SVG 水印，即使路径对也会静默失败，只认 PNG/JPG/GIF
真正难的不是生成随机数，而是让随机落在「视觉安全区」里——主体构图千变万化，靠固定边距不够，有些场景得结合图像分析（比如人脸检测）动态选点，那已经超出 TP 自带水印能力了。
