Node.js批量上传图片至Cloudinary时出现ETIMEDOUT错误求助

这问题我之前帮朋友排查过类似的！你遇到的ETIMEDOUT 52.200.235.1:443错误，本质是一下子发起了太多并发上传请求——因为你用forEach遍历文件时，会瞬间把所有上传请求都发出去，而不是等待前一个请求完成再处理下一个。这会导致Node.js同时建立大量TCP连接，要么触发自身的连接池限制，要么被Cloudinary的速率限制拦截，最终超时。

下面给你几个靠谱的解决方案，按易到难排序：

1. 改用异步串行遍历（最简单） #

把forEach换成for...of配合await，这样每次只处理一个上传请求，避免并发过载：

const fs = require('fs').promises; // 使用Promise版本的fs模块
const cloudinary = require('cloudinary').v2;

// 先配置你的Cloudinary信息
cloudinary.config({
  cloud_name: '你的云名称',
  api_key: '你的API密钥',
  api_secret: '你的API密钥'
});

async function batchUploadImages() {
  try {
    // 读取当前目录下的所有文件
    const files = await fs.readdir('.');
    
    for (const fileName of files) {
      // 过滤掉非图片文件（按需调整后缀）
      if (!fileName.match(/\.(jpg|jpeg|png|gif|webp)$/i)) {
        console.log(`跳过非图片文件：${fileName}`);
        continue;
      }

      console.log(`开始上传：${fileName}`);
      // 等待当前文件上传完成再处理下一个
      const uploadResult = await cloudinary.uploader.upload(fileName, {
        timeout: 60000, // 延长超时时间到60秒
        retry: 2 // 上传失败自动重试2次
      });
      console.log(`上传成功：${uploadResult.secure_url}`);
    }

    console.log('所有图片上传完成！');
  } catch (error) {
    console.error('批量上传出错：', error);
  }
}

// 执行上传
batchUploadImages();

2. 控制并发数（兼顾速度和稳定性） #

如果不想完全串行，想同时处理3-5个上传请求，可以用p-limit库来限制并发数：

首先安装依赖：

npm install p-limit

然后修改代码：

const fs = require('fs').promises;
const cloudinary = require('cloudinary').v2;
const pLimit = require('p-limit');

cloudinary.config({
  // 你的Cloudinary配置
});

// 设置最大并发数为3
const uploadLimit = pLimit(3);

async function batchUploadImages() {
  try {
    const files = await fs.readdir('.');
    
    // 把每个上传任务包装成受限制的Promise
    const uploadTasks = files.map(fileName => {
      if (!fileName.match(/\.(jpg|jpeg|png|gif)$/i)) {
        return Promise.resolve();
      }
      
      return uploadLimit(async () => {
        console.log(`开始上传：${fileName}`);
        const result = await cloudinary.uploader.upload(fileName, {
          timeout: 60000,
          retry: 2
        });
        console.log(`上传成功：${result.secure_url}`);
        return result;
      });
    });

    // 等待所有任务完成
    await Promise.all(uploadTasks);
    console.log('全部上传完成！');
  } catch (error) {
    console.error('上传出错：', error);
  }
}

batchUploadImages();

3. 调整Node.js连接池配置（进阶） #

如果上面的方法还不行，可以手动调整Node.js的HTTPS连接池最大socket数，避免连接耗尽：

const https = require('https');
// 把最大socket数设置为10（按需调整，不要太大）
https.globalAgent.maxSockets = 10;

关键注意点 #

• 一定要过滤非图片文件，避免上传无效文件浪费请求；
• 加上timeout和retry参数，应对网络波动导致的临时失败；
• 不要一次性发起超过10个并发请求，Cloudinary对免费用户有速率限制，太容易触发拦截。

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