Node.js对接Keycloak登录失败：请求路径找不到资源

问题描述 #

我希望通过Node.js对接部署在虚拟机容器中的Keycloak实例完成登录操作，使用的代码如下：

const axios = require('axios');

function loginToKeycloak(username, password, clientId, realmName) {
    const keycloakUrl = 'https://<ip of my virtual machine>:8443/auth/realms/';
    const tokenEndpoint = `${keycloakUrl}${realmName}/protocol/openid-connect/token`;

    const data = {
        grant_type: 'password',
        client_id: clientId,
        username,
        password,
    };

    axios.post(tokenEndpoint, new URLSearchParams(data), {
        headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
        },
        httpsAgent: new (require('https').Agent)({ rejectUnauthorized: false }), // Ignore self-signed certificate
    })
        .then((response) => {
            console.log('Login successful');
            console.log('Access Token:', response.data.access_token);
        })
        .catch((error) => {
            console.error('Login failed:', error.response ? error.response.data : error.message);
        });
}

loginToKeycloak('myUser', 'myPassword!', 'myClient', 'myRealm');

执行后出现如下错误：

'RESTEASY003210: Could not find resource for full path: https://<ip of my virtual machine>:8443/auth/realms/realm1/protocol/openid-connect/token'

浏览器中输入https://<ip of my virtual machine>:8443/可正常访问Keycloak首页，地址看似正确，求解决登录失败的问题。

解决步骤 #

1. 修正Keycloak API路径（针对17+版本） #

Keycloak 17及以后的Quarkus版本，默认移除了路径中的/auth前缀。当前代码中的keycloakUrl包含/auth，会导致端点路径错误。
修改keycloakUrl为：

const keycloakUrl = 'https://<ip of my virtual machine>:8443/realms/';

修改后请求的token端点路径将符合新版本规范。

2. 核对Realm名称一致性 #

错误信息中显示请求的是realm1，但代码调用时传入的是myRealm，存在名称不匹配问题：

• 登录Keycloak后台，确认目标Realm的准确名称（注意大小写敏感）
• 确保loginToKeycloak函数的realmName参数与后台Realm名称完全一致

3. 检查客户端配置 #

密码授权模式对客户端有特定要求：

• 登录Keycloak后台找到myClient：
  • 确认Access Type设置为confidential或public
  • 若为confidential类型，需在请求数据中添加client_secret字段，值为客户端的凭证密钥
  • 确保开启Direct Access Grants Enabled选项（密码授权必须开启）

4. 验证端点可达性 #

在虚拟机内部执行以下命令，验证OpenID配置端点是否正常响应：

• 新版本Keycloak：

  curl -k https://localhost:8443/realms/<你的Realm名称>/.well-known/openid-configuration
  

• 旧版本Keycloak：

  curl -k https://localhost:8443/auth/realms/<你的Realm名称>/.well-known/openid-configuration
  

如果能返回JSON格式的配置信息，说明端点路径正确且网络可达。

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