创建自定义REST端点遇WordPress错误及500路由无效问题求助

一、激活插件时的"意外输出"错误 #

错误原因 #

1. 语法缺失：代码中include connect.php末尾缺少分号，PHP解析时会抛出语法错误，输出错误信息，触发WordPress的"意外输出"提示。
2. 文件路径风险：直接使用connect.php可能导致路径找不到，PHP会输出警告信息，同样引发该问题。

修复方法 #

• 给include语句加上分号，并使用绝对路径确保文件能被正确加载：

include plugin_dir_path(__FILE__) . 'connect.php';

• 同时检查connect.php文件开头/结尾是否有多余的空白、换行，这些也可能导致输出问题。

二、REST端点返回"The handler for the route is invalid."错误 #

错误原因 #

1. 回调函数格式错误：register_rest_route的callback参数使用了['collegeid']，这是调用类方法的格式（数组需包含类/实例和方法名），但collegeid是普通全局函数，格式不匹配。
2. 数据库查询及返回值问题：
   • collegeid函数直接返回mysqli_query的结果集对象，REST API无法直接序列化这个对象，需要转换为可输出的数组。
   • SQL语句中SELECT 'id'的单引号会把id当作字符串常量返回，而非查询Colleges表的id字段，应改为SELECT id或SELECT id``。
   • $dbuser、$dbpass、$dbname变量未定义，需确保这些变量在connect.php中正确声明，或者在函数内定义。
3. 未处理数据库连接/查询错误：没有对mysqli连接失败、查询失败的情况做处理，会导致内部错误。

修复方法 #

1. 修正回调函数格式，直接使用函数名字符串：

'callback' => 'collegeid',

2. 重构collegeid函数，完善数据库操作和响应格式：

function collegeid() {
    // 确保connect.php中已定义$dbuser、$dbpass、$dbname
    global $dbuser, $dbpass, $dbname;
    
    $db = new mysqli('localhost', $dbuser, $dbpass, $dbname);
    
    // 检查连接错误
    if ($db->connect_error) {
        return new WP_Error('db_connection_failed', '数据库连接失败', array('status' => 500));
    }
    
    // 修正SQL语句，查询id字段而非字符串'id'
    $queryusers = "SELECT id FROM `Colleges`";
    $dbc = $db->query($queryusers);
    
    // 检查查询错误
    if (!$dbc) {
        return new WP_Error('db_query_failed', '查询失败', array('status' => 500));
    }
    
    // 将结果集转换为数组
    $schools = array();
    while ($row = $dbc->fetch_assoc()) {
        $schools[] = $row;
    }
    
    // 关闭数据库连接
    $db->close();
    
    // 返回REST响应
    return rest_ensure_response($schools);
}

3. 确保connect.php中正确定义数据库变量，示例：

<?php
$dbuser = '你的数据库用户名';
$dbpass = '你的数据库密码';
$dbname = '你的数据库名';
?>

三、其他注意事项 #

• 建议使用WordPress内置的$wpdb类操作数据库，而非直接使用mysqli，这样能更好地和WordPress环境兼容，避免重复连接数据库。
• 权限回调__return_true会让端点完全公开，若需要限制访问，可替换为自定义权限检查函数。

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