WordPress多站点出现net::ERR_HTTP2_PROTOCOL_ERROR问题求助

• 检查HTTP/2配置

  • 登录OpenLiteSpeed WebAdmin控制台（默认端口7080），进入Server Configuration > Tuning，确认HTTP/2选项已开启；可临时禁用HTTP/2切换回HTTP/1.1，测试错误是否消失，以此判断是否为HTTP/2配置冲突。
  • 验证服务器SSL证书的有效性，HTTP/2对SSL证书要求严格，过期、自签或不匹配的证书可能触发协议错误。

• 验证WordPress多站点Rewrite规则

  • 确认OpenLiteSpeed的mod_rewrite模块已激活，在Server Configuration > Modules中查看状态。
  • 检查根目录下的.htaccess文件，确保多站点Rewrite规则配置正确：

    RewriteEngine On
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
    RewriteBase /
    RewriteRule ^index\.php$ - [L]
    
    RewriteRule ^wp-admin$ wp-admin/ [R=301,L]
    
    RewriteCond %{REQUEST_FILENAME} -f [OR]
    RewriteCond %{REQUEST_FILENAME} -d
    RewriteRule ^ - [L]
    RewriteRule ^(wp-(content|admin|includes).*) $1 [L]
    RewriteRule ^(.*\.php)$ $1 [L]
    RewriteRule . index.php [L]
    

  • 执行sudo systemctl restart lsws重启OpenLiteSpeed，使规则生效。

• 排查资源加载限制

  • 在OpenLiteSpeed控制台Server Configuration > Tuning中，调高Max Request Body Size至64M以上，避免自定义页面时大资源加载触发限制。
  • 检查PHP配置文件php.ini中的upload_max_filesize和post_max_size，确保与OpenLiteSpeed的设置匹配，修改后重启PHP服务。

• 排查插件/主题冲突

  • 临时禁用所有WordPress插件，测试页面自定义功能是否恢复；若正常，逐个启用插件定位冲突项。
  • 切换至WordPress默认主题（如Twenty Twenty-Four），排查是否为当前主题代码导致协议错误。

• 分析服务器日志

  • 查看OpenLiteSpeed错误日志（默认路径/usr/local/lsws/logs/error.log），查找与HTTP/2相关的报错信息。
  • 开启WordPress调试日志，在wp-config.php中添加以下代码：

    define('WP_DEBUG', true);
    define('WP_DEBUG_LOG', true);
    define('WP_DEBUG_DISPLAY', false);
    

    查看wp-content/debug.log中的PHP错误或警告，定位潜在问题。

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