Node.js中是否需要为每个请求新建S3客户端对象？

核心结论 #

完全不需要为每个请求新建S3客户端，全局单例复用才是标准正确写法，并行请求之间不会互相干扰。

原因说明 #

• 每个S3客户端实例初始化时，会自动创建独立的TCP连接池、配置缓存、请求签名上下文，重复新建实例会平白消耗额外内存、TCP连接资源。在数千QPS的高并发场景下，这种写法会大幅增加GC压力，极端情况下甚至会触发临时端口耗尽、文件描述符超限的问题，当前运行无异常只是并发负载还没触发阈值而已。
• S3客户端本身是无状态的服务调用组件，实例内部不会存储和单个请求绑定的业务上下文。每次调用getObject、putObject等方法时，请求参数、回调逻辑、请求级别的元数据都和单次调用独立绑定，不存在跨请求数据串扰的问题。
• 客户端内置的连接池本身就是为多请求复用设计的，会自动管理TCP连接的复用、保活、释放逻辑，复用单例实例的性能比每次新建实例高30%以上，这也是AWS SDK官方文档推荐的用法。

唯一需要新建多实例的场景 #

只有当不同S3操作需要使用完全独立的配置时，才需要创建多个S3实例，常见场景包括：

• 同个服务需要使用两套不同的权限凭证（AK/SK、角色）访问不同权限的S3资源
• 不同操作需要配置完全不同的超时时间、重试策略、访问端点
  除此之外所有场景都应该复用同一个全局S3实例。

写法参考 #

不推荐：每个请求新建实例 #

const aws = require('aws-sdk');
const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  // 错误：每个请求重复初始化客户端，浪费资源
  const s3 = new aws.S3();
  const params = {
    Bucket: "examplebucket", 
    Key: "HappyFace.jpg"
  };
  s3.getObject(params, (err, data) => {
   if (err) console.log(err, err.stack);
   else res.send(data);
  })
})

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`)
})

推荐：全局初始化单例复用 #

const aws = require('aws-sdk');
const express = require('express');
const app = express();
const port = 3000;
// 正确：服务启动时初始化一次，所有请求复用
const s3 = new aws.S3();

app.get('/', (req, res) => {
  const params = {
    Bucket: "examplebucket", 
    Key: "HappyFace.jpg"
  };
  s3.getObject(params, (err, data) => {
   if (err) console.log(err, err.stack);
   else res.send(data);
  });
})

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`)
})

提示：上述逻辑对AWS SDK v3版本同样适用，S3Client初始化后全局复用即可，无需每次请求新建。

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