如何用AWS SDK v3重构v2全局配置类（含代理与凭证访问）

AWS SDK v3 移除了 v2 中AWS.config这类全局配置入口，无法直接通过全局更新实现所有客户端的代理统一配置。但可以通过抽离通用配置工厂+客户端创建封装的方式，实现和原v2代码等价的效果，避免重复编写代理判断逻辑。

实现方案代码 #

import { Agent } from "https";
import { proxyAgent } from "proxy-agent";
import { fromIni } from "@aws-sdk/credential-providers";
import { RegionInputConfig } from "@aws-sdk/types";

// 读取环境变量中的代理配置
const HTTPS_PROXY = process.env.HTTPS_PROXY;

export class AWSConfig {
  static readonly region = "eu-west-1";

  // 生成所有客户端共用的基础配置（含代理、区域、凭证）
  private static getBaseConfig<T extends RegionInputConfig>(): T {
    const baseConfig: Record<string, any> = {
      region: this.region,
      // 复用v2默认凭证链逻辑：优先环境变量，其次~/.aws/credentials文件等
      credentials: fromIni()
    };

    // 存在代理时注入httpsAgent
    if (HTTPS_PROXY) {
      baseConfig.httpsAgent = proxyAgent(HTTPS_PROXY) as Agent;
    }

    return baseConfig as T;
  }

  // S3客户端创建封装
  static createS3Client() {
    const { S3Client } = require("@aws-sdk/client-s3");
    return new S3Client(this.getBaseConfig());
  }

  // SNS客户端创建封装
  static createSNSClient() {
    const { SNSClient } = require("@aws-sdk/client-sns");
    return new SNSClient(this.getBaseConfig());
  }

  // 等价于原代码中访问AWS.config.credentials的方法
  static async getCredentials() {
    const credentialProvider = fromIni();
    return credentialProvider();
  }
}

核心逻辑说明 #

1. 统一配置抽离：getBaseConfig方法集中处理代理、区域、凭证等公共配置，所有客户端创建时复用该方法，避免重复判断代理逻辑。
2. 凭证兼容：fromIni凭证提供者完全对齐v2中AWS.config.credentials的默认行为，自动从环境变量、本地凭证文件、IAM角色等渠道获取凭证。
3. 客户端封装：通过静态工厂方法createS3Client/createSNSClient统一创建客户端，确保所有实例使用相同配置。

使用示例 #

// 创建S3客户端
const s3Client = AWSConfig.createS3Client();
// 创建SNS客户端
const snsClient = AWSConfig.createSNSClient();
// 获取当前凭证（对应原AWS.config.credentials）
const credentials = await AWSConfig.getCredentials();

扩展说明 #

• 如果需要添加其他全局配置（如签名版本、超时时间），直接在getBaseConfig中追加即可。
• 若需自定义凭证来源，可替换fromIni为其他官方凭证提供者（如fromEnv、fromSSO），或自定义符合CredentialProvider类型的函数。

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