WordPress(WPMU)创建新站点未在wp_blogs表插入数据问题咨询

可能的触发原因 #

• 数据库权限/规则限制：子站点对应数据表可创建，但wp_blogs表的写入权限被单独限制，或数据库层面的触发器、安全规则拦截了针对wp_blogs的INSERT操作
• 自定义代码/插件钩子冲突：第三方多站点管理插件、自定义主题使用了wpmu_new_blog、wp_insert_site等站点创建生命周期钩子，逻辑异常终止了后续写入流程，或错误过滤了待写入wp_blogs的合法数据
• wp_blogs表结构损坏：表的主键约束、字段属性被修改，例如blog_id的自增属性丢失、新增了无默认值的必填自定义字段，导致插入语句执行失败但无前端可见报错
• 持久化对象缓存异常：Redis、Memcached等对象缓存配置错误，写入wp_blogs的操作被缓存拦截未落地到持久化数据库
• 多站点配置参数错误：wp-config.php中DOMAIN_CURRENT_SITE、PATH_CURRENT_SITE等多站点核心配置和实际部署环境不匹配，导致插入逻辑判断不通过，跳过了wp_blogs写入步骤

排查调试步骤 #

• 开启WordPress调试模式，在wp-config.php中添加以下配置：

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

重现子站点创建操作后，查看wp-content/debug.log日志，重点查找wp_blogs表插入相关的数据库报错信息

• 临时禁用所有第三方插件，切换为WordPress默认主题，重新测试子站点创建。如果恢复正常，再逐个启用插件、切换主题，定位冲突的代码项
• 校验wp_blogs表结构，确认blog_id为自增主键，domain、path、site_id、registered等核心字段无额外约束修改，可执行REPAIR TABLE wp_blogs语句尝试修复损坏的表结构
• 临时关闭所有对象缓存功能，注释wp-config.php中的缓存相关配置，再次测试创建子站点，排查是否为缓存拦截导致的写入失败
• 手动打印站点插入SQL，在wp-includes/ms-site.php的wp_insert_site函数执行INSERT操作前，临时添加日志输出待插入数据和最终生成的SQL语句，手动执行该SQL验证是否存在执行错误

实际场景解决经验 #

• 安全插件的数据库写入防护规则误判wp_blogs插入操作为恶意行为，将WPMU站点创建逻辑添加到插件白名单后即可恢复正常
• 手动修改过wp_blogs表新增了自定义必填字段，WordPress默认插入逻辑不会为该字段赋值导致插入失败，删除自定义字段或为字段设置默认值即可解决
• 云服务商的数据库审计功能开启严格拦截规则时，也可能拦截WPMU批量建表后的wp_blogs写入操作，临时关闭审计规则即可验证是否为此类问题

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