基于API Gateway与Lambda的Steam OpenID认证报错求助

问题场景 #

我在AWS API Gateway配置了两个Lambda端点，用于实现Steam OpenID认证，使用的是node-steam-openid的TS版本（对应项目内的utils/steamAuth模块）。

现有代码 #

/login 端点 #

// the steamAuth file is the same module as node-steam-openid but for ts
import { SteamAuth } from "../utils/steamAuth";

export const login = async () => {
  const client = new SteamAuth(
      'http://localhost:3000',
      `${process.env.API_URL}/consume`,
      process.env.STEAM_API_KEY,
  );

  try {
    const redirectUrl = await client.getRedirectUrl();
    return {
      statusCode: 302,
      headers: { Location: redirectUrl }
    };
  } catch (e) {
    console.log(e);
    return {
      statusCode: 500,
      message: 'Internal server error'
    };
  }
}

/consume 端点 #

import { APIGatewayEvent } from 'aws-lambda';
import { SteamAuth } from "../utils/steamAuth";

export const consume = async (event: APIGatewayEvent) => {
  const client = new SteamAuth(
      'http://localhost:3000',
      `${process.env.API_URL}/consume`,
      process.env.STEAM_API_KEY,
  );

  console.log(event);

  try {
    const user = await client.authenticate(event);
    console.log('success', user);
  } catch (e) {
    console.log('error', e);
  }

  return {
    statusCode: 302,
    headers: { Location: 'http://localhost:3000/' },
  };
}

报错信息 #

调用/consume端点时触发以下错误：

error TypeError: Cannot read property 'toUpperCase' of undefined
    at Object.openid.verifyAssertion (/var/task/node_modules/openid/openid.js:905:28)
    at openid.RelyingParty.verifyAssertion (/var/task/node_modules/openid/openid.js:68:10)
    at /var/task/src/utils/steamAuth.js:60:31
    at new Promise (<anonymous>)
    at SteamAuth.authenticate (/var/task/src/utils/steamAuth.js:59:16)
    at Runtime.consume [as handler] (/var/task/src/lambda/consume.js:9:35)
    at Runtime.handleOnceNonStreaming (/var/runtime/Runtime.js:73:25)

问题分析 #

报错根源在于verifyAssertion依赖的底层库期望接收Express风格的request对象，但实际传入的是AWS API Gateway Event对象——两者结构差异导致库无法读取method等核心属性，进而触发toUpperCase的undefined错误。

解决方案（无需修改模块源码） #

方案1：封装API Gateway Event为Express兼容请求对象 #

无需替换现有模块，只需在调用authenticate前，把API Gateway Event转换成符合Express request结构的对象，模拟底层库所需的属性：

// 在consume函数中添加转换逻辑
const mockExpressReq = {
  method: event.httpMethod,
  url: event.path,
  query: event.queryStringParameters || {},
  headers: event.headers || {},
  // 可根据openid库的http.js逻辑补充其他必要属性
};

// 传入转换后的对象调用认证方法
const user = await client.authenticate(mockExpressReq);

该方法能让底层库正确读取所需属性，快速解决兼容性问题。

方案2：使用Serverless友好的Steam认证库 #

如果不想做对象转换，可选择原生支持Serverless环境的Steam认证方案：

• steam-login：轻量Steam OpenID实现，支持直接处理query参数，无需依赖Express请求对象。使用时直接从API Gateway Event的queryStringParameters中提取OpenID断言参数，传入库的验证方法即可。
• passport-steam + serverless-http：结合Passport的Steam策略与serverless-http中间件，将Lambda函数包装为Express兼容的处理函数，直接复用passport-steam的完整认证流程，无需手动转换对象。

总结 #

如果希望保留现有模块，优先选择方案1；如果追求长期维护的顺畅性，可考虑方案2改用Serverless友好的认证工具链。

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