IIS双服务器负载均衡部署WordPress Essentials主题预览报错500

1. 开启调试模式定位具体错误 #

优先拿到明确的报错信息缩小排查范围：
编辑站点根目录的wp-config.php文件，修改以下配置项：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 错误会输出到wp-content/debug.log文件
define( 'WP_DEBUG_DISPLAY', false ); // 生产环境建议关闭页面直接展示错误

修改后重新触发预览500错误，查看wp-content/debug.log文件里的报错内容，即可定位是代码错误、依赖缺失还是权限问题。 #

2. 排除负载均衡配置问题 #

你使用了双IIS节点负载均衡架构，先做单节点验证：

• 暂时将负载均衡流量全部切到其中一台IIS服务器，直接访问该节点后台尝试预览主题
• 再切换到另一台节点重复上述操作
  • 如果单节点访问仍报错，说明是该节点的本地配置问题
  • 如果两台单节点访问都正常，说明是负载均衡未开启粘性会话（会话保持）：WordPress自定义预览功能需要同一个用户的连续请求落到同一台后端服务器，否则会话、变更集UUID不匹配会触发500错误，开启负载均衡的粘性会话即可解决。

3. 排查essentials主题本身问题 #

默认主题twentynineteen可正常预览，说明WordPress核心配置无异常，重点排查主题相关问题：

• 检查环境依赖：确认两台IIS的PHP版本、必填扩展（curl、gd、mbstring、zip等）都符合主题的最低要求，可新建phpinfo.php文件对比两台节点的PHP配置差异，缺失扩展统一安装启用。
• 检查目录权限：确认两台节点的\wp-content\themes\essentials目录，都给IIS运行用户（IUSR、IIS_IUSRS组）配置了读取、执行权限，权限配置两台必须完全一致。
• 排查插件冲突：临时禁用所有已安装的WordPress插件，再尝试预览主题，如果恢复正常就逐个启用插件，定位冲突的插件后做兼容处理或替换插件。

4. 排查IIS配置差异 #

对比两台IIS服务器的站点配置：

• 检查PHP处理程序映射、PHP.ini配置是否完全一致
• 检查站点根目录的web.config重写规则是否一致，有没有针对主题路径的规则冲突
• 查看IIS站点日志（默认路径%SystemDrive%\inetpub\logs\LogFiles对应站点ID的目录），找到500错误的子状态码：500.0代表PHP脚本执行错误，500.50代表URL重写规则错误，可进一步缩小排查范围。

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