Next-Auth集成Keycloak Provider失败问题求助

核心问题定位 #

错误connect ECONNREFUSED ::1:8080说明Next-Auth无法通过IPv6地址（::1是localhost的IPv6映射）连接到Keycloak服务器，而GitHub集成正常，证明Next-Auth核心配置逻辑无问题，故障集中在Keycloak的网络可达性或配置细节上。

针对性解决方法 #

1. 替换Keycloak地址为IPv4格式 #

Node.js解析localhost时默认优先使用IPv6，但你的Keycloak可能仅绑定了IPv4的127.0.0.1，导致连接失败。修改issuer配置：

KeycloakProvider({
    id: "name",
    clientId: "next-client",
    clientSecret: "1231dasf23rFsafFASFarfdgfdg",
    issuer: 'http://127.0.0.1:8080/auth/realms/myrealm', // 替换localhost为127.0.0.1
})

2. 验证Keycloak运行状态与端口占用 #

• 检查Keycloak是否启动：ps aux | grep keycloak（Linux/macOS）或tasklist | findstr keycloak（Windows）
• 确认8080端口未被占用：lsof -i :8080（Linux/macOS）或netstat -ano | findstr :8080（Windows）
• 若端口被占用，停止占用进程或修改Keycloak端口配置。

3. 修正Keycloak客户端重定向URL #

Keycloak客户端的Valid Redirect URIs不能仅设置http://localhost:3000，必须包含完整的Next-Auth回调路径：http://localhost:3000/api/auth/callback/name（其中name是你给KeycloakProvider设置的id，需完全一致）

4. 修复Next-Auth的debug配置错误 #

你的配置中debug:"true"是字符串类型，需改为布尔值true才能正常输出调试日志：

export default NextAuth({
    debug: true, // 修正为布尔值
    // 其余配置不变
})

修正后的完整代码示例 #

import NextAuth from "next-auth"
import KeycloakProvider from "next-auth/providers/keycloak";
import GitHubProvider from "next-auth/providers/github";

export default NextAuth({
    debug: true,
    providers: [
        KeycloakProvider({
            id: "name",
            clientId: "next-client",
            clientSecret: "1231dasf23rFsafFASFarfdgfdg",
            issuer: 'http://127.0.0.1:8080/auth/realms/myrealm',
        }),
        GitHubProvider({
            clientId: "It2.cafasdfsads",
            clientSecret: "213dascdg123r1f32f1fcwecwq"
        })
    ],
})

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