NestJS中GraphQL解析器调用外部HTTP请求挂起问题排查

核心问题 #

NestJS项目中，同一AuthService的checkme方法在REST控制器的AuthGuard调用时，Axios请求外部认证API正常；但在GraphQL解析器调用时，该HTTP请求挂起超时。移除实际HTTP调用后，REST与GraphQL均正常，问题锁定在Axios请求的执行逻辑上。

可能原因与对应解决方案 #

1. Axios配置键名错误 #

代码中使用了baseUrl（小写U），但Axios的标准配置键是baseURL（大写U），这会导致URL拼接异常，请求无法正确发送进而挂起。

修复代码：

async checkme(request: Request): Promise<boolean> {
    try {
        await this.authClient.get("/me", {
            baseURL: "https://localhosts/auth", // 修正为标准键名baseURL
            headers: {...request.headers}, // 浅拷贝headers，避免引用传递问题
        }); 
        return true
    } catch { 
        return false    
    }
}

2. 请求头结构不兼容 #

GraphQL上下文的req.headers可能包含非标准字段（如WebSocket相关的connection、upgrade字段），或是不可枚举的对象，导致Axios无法正确处理。

修复方案：只传递认证必需的头字段

async checkme(request: Request): Promise<boolean> {
    try {
        // 仅提取认证相关的请求头，避免传递冗余字段
        const authHeaders = {
            Authorization: request.headers.authorization,
            Cookie: request.headers.cookie
        };
        await this.authClient.get("/me", {
            baseURL: "https://localhosts/auth",
            headers: authHeaders,
        }); 
        return true
    } catch { 
        return false    
    }
}

3. GraphQL上下文请求对象传递异常 #

确保GraphQL模块配置中正确将HTTP请求对象注入上下文：

GraphQLModule.forRoot({
    // 其他配置项
    context: ({ req }) => ({ req }), // 保证req对象正确传递到解析器上下文
})

4. Axios实例拦截器阻塞 #

如果注入的authClient配置了请求/响应拦截器，可能在GraphQL场景下出现Promise死锁或未正确处理的情况。可暂时移除拦截器测试，确认是否恢复正常。

验证步骤 #

1. 优先修正baseURL的大小写错误，测试GraphQL请求
2. 若问题仍存在，对比REST与GraphQL场景下request.headers的结构差异，针对性过滤字段
3. 确认GraphQL上下文的req对象与REST请求对象结构一致

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