迁移至AWS SDK v3：通用包装器的最优设计模式选型咨询

工厂模式完全适配你的场景 #

针对AWS SDK v3的模块化客户端设计，工厂模式是非常合适的选择——它能帮你统一处理不同客户端的初始化、通用配置注入和日志逻辑包装，同时保持业务侧的使用体验和原生v3客户端一致。

核心实现思路 #

• 工厂函数接收客户端构造器（比如LambdaClient、S3Client）和业务侧传入的基础配置
• 在工厂内部完成通用逻辑的封装：合并全局默认配置、包装send方法实现日志记录
• 返回经过增强的客户端实例，业务侧直接用原生方式调用即可

代码示例 #

工厂函数实现

// aws-client-factory.js
import { AppLogger } from './your-team-logger';

export function createAwsClient(ClientConstructor, customConfig = {}) {
  // 合并通用配置与业务侧自定义配置
  const finalConfig = {
    retryMode: 'standard',
    region: process.env.AWS_DEFAULT_REGION,
    ...customConfig
  };

  // 初始化原生客户端
  const rawClient = new ClientConstructor(finalConfig);

  // 包装send方法，注入通用日志逻辑
  const originalSend = rawClient.send;
  rawClient.send = async (command) => {
    const commandName = command.constructor.name;
    AppLogger.info(`[AWS 请求] ${commandName}, 参数: ${JSON.stringify(command.input)}`);
    
    try {
      const response = await originalSend.call(rawClient, command);
      AppLogger.info(`[AWS 响应] ${commandName}, 状态: 成功`);
      return response;
    } catch (error) {
      AppLogger.error(`[AWS 错误] ${commandName}, 详情: ${error.message}`);
      throw error; // 不吞错误，交给业务侧处理
    }
  };

  return rawClient;
}

业务侧使用示例

// 调用Lambda服务
import { LambdaClient, InvokeCommand } from '@aws-sdk/client-lambda';
import { createAwsClient } from './aws-client-factory';

// 创建经过包装的Lambda客户端
const lambdaClient = createAwsClient(LambdaClient, {
  maxAttempts: 5 // 业务侧自定义配置
});

// 和原生v3调用方式完全一致
await lambdaClient.send(new InvokeCommand({
  FunctionName: 'user-processing-function',
  Payload: JSON.stringify({ userId: '123' })
}));

可选的优化方向 #

• 结合装饰器模式：如果需要拆分不同的通用逻辑（比如日志、监控、重试策略），可以把这些逻辑做成独立的装饰函数，工厂负责组合这些装饰器，扩展性更强
• TypeScript类型支持：给工厂函数添加泛型约束，确保类型安全：

import type { Client } from '@aws-sdk/smithy-client';

export function createAwsClient<T extends Client<any, any, any>>(
  ClientConstructor: new (config: any) => T,
  customConfig: any = {}
): T {
  // 实现逻辑同JS版本，添加类型注解即可
}

• 全局配置预设：在工厂内部维护一套团队通用的默认配置（比如统一的重试次数、超时时间），业务侧仅需传入差异化配置

总结 #

工厂模式完美适配AWS SDK v3的模块化特性，核心优势在于：

• 统一管理所有AWS客户端的初始化逻辑，避免重复代码
• 封装通用的日志、配置增强逻辑，业务侧无需关心底层细节
• 对业务代码侵入性极低，使用方式和原生v3客户端一致，学习成本几乎为零

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