Node.js中使用AWS SDK通过SSO凭证访问AWS资源报缺失凭证错误

• 版本混用不兼容：当前代码引入的aws-sdk是经典v2版本客户端，但同时引入的@aws-sdk/credential-provider-node、@aws-sdk/credential-provider-sso属于v3生态的独立凭证组件，v2客户端无法完全适配v3凭证组件的调用逻辑，会直接判定凭证缺失。
• 环境变量未生效：通过Windowssetx命令设置的系统环境变量，仅对设置完成后新启动的进程有效。如果运行应用的终端、IDE是在设置环境变量之前打开的，当前进程根本读不到AWS_SDK_LOAD_CONFIG=1的值，SDK自然找不到config文件里的SSO配置。
• 前置状态缺失：没有提前通过AWS CLI完成对应profile的SSO登录，本地~/.aws/sso/cache目录没有有效的临时登录凭证，SDK自然拿不到可用凭证。

方案1：保留现有v2版本依赖，最小改动调整 #

v2版本从2.700.0开始已原生支持SSO配置，不需要额外引入第三方凭证包，按如下修改即可跑通：

• 代码开头手动设置配置加载开关，不依赖系统环境变量，从根源避免环境变量不生效的问题
• 实例化客户端时直接传入profile参数，SDK会自动匹配config文件里的SSO配置拉取临时凭证

// 必须写在代码最开头，确保SDK初始化时能读到配置开关
process.env.AWS_SDK_LOAD_CONFIG = 1;
// 如果config文件不在系统默认用户目录下，可额外指定文件绝对路径
// process.env.AWS_CONFIG_FILE = "C:/Users/你的用户名/.aws/config";

const AWS = require("aws-sdk");
const route53 = new AWS.Route53({
  profile: "my-sso-profile",
  region: "us-east-1"
});

前置检查：

• 提前在终端执行aws sso login --profile my-sso-profile完成SSO登录，确保本地有有效的SSO缓存
• 确认安装的aws-sdk版本不低于2.700.0，过低的版本不支持SSO加载能力

方案2：统一切换到v3生态，彻底规避版本兼容问题 #

如果选择升级到v3版本，不要继续使用v2的Route53客户端，安装对应服务包后再使用之前的凭证provider逻辑即可：

• 先安装所需依赖：@aws-sdk/client-route-53、@aws-sdk/credential-provider-sso
• 代码调整如下：

// 同样需要在代码开头开启配置文件加载开关
process.env.AWS_SDK_LOAD_CONFIG = 1;

const { fromSSO } = require("@aws-sdk/credential-provider-sso");
const { Route53 } = require("@aws-sdk/client-route-53");

const route53 = new Route53({
  region: "us-east-1",
  credentials: fromSSO({ profile: "my-sso-profile" })
});

• SSO相关的所有profile配置必须放在~/.aws/config文件中，不要放到~/.aws/credentials文件里，否则SDK无法识别
• 运行应用前如果刚修改过系统环境变量，一定要重启终端或IDE，避免旧进程读不到最新的环境配置
• 不要在v2客户端中手动传入v3组件生成的凭证对象，直接传profile参数让SDK内部自动加载是最稳定的方式

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