如何在PHP中抛出自定义错误至Axios的.catch方法

DevOps 小满

2026-7-23

如何从PHP向Axios的.catch传递自定义错误

Axios的.catch()分支默认只会在HTTP状态码不在2xx范围内时触发，所以要让自定义错误进入这个分支，PHP需要先返回一个非2xx的状态码，再输出自定义错误信息。

1. 修改PHP代码：设置错误状态码+输出错误JSON

在验证失败的分支里，先用http_response_code()设置一个合适的错误状态码（比如401代表未授权，400代表参数错误），再输出包含自定义错误的JSON：

// 可选：设置响应内容类型为JSON，让前端解析更规范
header('Content-Type: application/json');

if ($username === 'admin' && $password === '123') {
    echo json_encode(['success' => true]);
} else {
    // 设置HTTP错误状态码，触发Axios的catch
    http_response_code(401);
    echo json_encode(['error' => 'Invalid username or password']);
}

2. 修改Axios代码：在catch中获取自定义错误

Axios的错误对象里，error.response.data会包含PHP返回的自定义错误内容，直接读取即可：

axios.post('login.php', { username, password })
    .then(response => {
        console.log(response.data);
        // 处理登录成功逻辑
    })
    .catch(error => {
        // 优先获取PHP返回的自定义错误
        if (error.response) {
            console.error('登录失败:', error.response.data.error);
        } else {
            // 处理请求本身失败的情况（比如网络错误）
            console.error('请求出错:', error.message);
        }
    });