Node.js中Axios调用Keycloak获AccessToken失败，Postman可正常请求

问题现象 #

通过Node.js的Axios调用Keycloak获取access token时，请求失败并报错connect ECONNREFUSED ::1:8080，但相同请求在Postman中可成功执行。

排查与解决步骤 #

1. 修复IPv6/IPv4解析问题 #

报错中的::1是IPv6本地回环地址，Node.js解析localhost时可能优先使用IPv6，但你的Keycloak可能仅监听了IPv4端口。Postman通常默认使用IPv4的127.0.0.1访问，因此可以正常连接。

解决方式：将请求URL中的localhost替换为127.0.0.1：

url:'http://127.0.0.1:8080/realms/Demo-Realm/protocol/openid-connect/token'

2. 修正Axios请求参数错误 #

Node.js环境下的Axios需要使用data字段传递请求体，而不是body（body是浏览器端XHR的参数）。原代码中使用body会导致请求体无法正确发送，进而引发连接或处理异常。

修正后的完整代码：

var requestObject= querystring.stringify({
    grant_type: "client_credentials",
    client_id: "demo-api",
    client_secret: "<client-secret>"
    // 注意：client_credentials模式无需传入username和password，可直接删除这两个参数
    // username: "<user>",
    // password: "<password>"
});

const config = {
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        "Accept":"*/*",
    }
}
try {
    const keycloakResponse = await axios({
        method: 'POST',
        url:'http://127.0.0.1:8080/realms/Demo-Realm/protocol/openid-connect/token',
        data: requestObject, // 替换body为data
        headers: config.headers
    });
    res.send(keycloakResponse.data); // 返回响应体数据而非整个响应对象
} catch (error) {
    console.error(error); // 控制台打印错误便于调试
    res.status(500).send({
        message: error.message,
        code: error.code
    });
}

3. 额外优化点 #

• 授权模式参数校验：client_credentials模式不需要username和password，这两个参数属于password授权模式，多余参数可能干扰Keycloak的请求处理。
• 端口可达性验证：在终端执行curl http://127.0.0.1:8080，确认Keycloak服务正常运行且端口未被防火墙/安全软件拦截。
• 错误处理优化：捕获异常时优先在控制台打印完整错误信息，便于定位问题，返回给前端的错误信息简化关键字段即可。

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