WordPress Image Watermark插件无法工作，求问题排查方法

我明白这种老旧站点插件失效的头疼——明明提示操作成功却看不到水印，还不敢随便开全局debug被一堆错误淹没，太闹心了。结合你用的是WP 4.x最新版和Image Watermark插件，咱们一步步来定位问题：

1. 先确认插件兼容性 #

WordPress 4.x是比较早期的版本，很多新插件已经不再适配它了。你可以：

• 查看插件后台的「详情」页面，确认它标注的支持WP版本范围，如果是只支持5.x及以上，那你装的最新版插件肯定和站点不兼容。
• 尝试降级插件到适配WP 4.x的旧版本：在插件管理页面点击「高级选项」，找到历史版本下载，备份站点后替换当前插件文件再测试。

2. 抠细节检查水印设置 #

有时候不是插件坏了，是设置里的小细节没注意：

• 水印图片有效性：去媒体库确认你选的水印图片能正常打开，然后在插件设置里重新选择一次，避免路径缓存或错误。
• 水印可见性：把透明度调到100%、尺寸调大、位置选图片正中间，测试单张图片添加水印——说不定之前的设置让水印太透明/太小/在边缘被裁剪了，肉眼看不到而已。
• 批量处理范围：确认插件设置里的批量处理是覆盖「所有已存在的图片及缩略图」，有些插件默认只处理新上传的图片，或者只处理原图不处理缩略图。

3. 排除主题和插件冲突 #

老旧站点的主题和插件很容易互相干扰：

• 临时切换到WP 4.x对应的默认主题（比如Twenty Fourteen），然后测试添加水印。如果切换后生效，说明是当前主题的钩子函数或样式干扰了插件运行。
• 逐个禁用其他插件，每禁用一个就测试一次水印功能。找到冲突插件后，可以尝试更新该插件（如果有适配WP 4.x的更新），或者找替代插件。

4. 用针对性日志替代全局wp_debug #

全局开debug会被其他老旧插件的错误刷屏，咱们只记录Image Watermark的相关日志：
在wp-config.php里添加以下代码（注意放在/* That's all, stop editing! Happy publishing. */之前）：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

// 只过滤记录Image Watermark的日志
function filter_watermark_debug_log( $message ) {
    if ( strpos( $message, 'Image Watermark' ) !== false ) {
        return $message;
    }
    return '';
}
add_filter( 'debug_log', 'filter_watermark_debug_log' );

运行批量处理后，去wp-content/debug.log里找相关条目，就能精准看到插件运行时的错误了。

5. 检查服务器配置和文件权限 #

插件处理图片需要服务器支持和正确的权限：

• 图片文件夹权限：确认wp-content/uploads文件夹权限是755，里面的图片文件权限是644，插件需要写入权限才能修改图片。
• 图片处理扩展：检查服务器是否安装了GD库或Imagick（二选一即可）。如果WP 4.x有「站点健康」工具，直接在里面看PHP扩展；没有的话可以装个简单的phpinfo插件查看，或者联系主机商确认这两个扩展是否启用。

6. 先测试单张新上传图片 #

不要先批量处理，先上传一张全新的图片，看插件是否自动添加水印：

• 如果新上传的图片有水印，说明插件核心功能正常，问题出在批量处理旧图片的逻辑上（比如旧图片的元数据丢失、路径错误）。
• 如果新上传的也没有水印，那插件的核心处理逻辑就没生效，回到前面的兼容性和冲突排查步骤。

内容的提问来源于stack exchange，提问作者Khrisna Gunanasurya