Node.js ES Module模式下转换Cloudinary图片上传中间件遇阻求助

核心转换规则 #

ES模块（type: module）与CommonJS的核心差异在于导入导出语法，直接替换即可解决大部分问题：

• 把require()替换为import语法
• 把module.exports/exports替换为export/export default
• 相对路径导入必须添加.js扩展名

1. 中间件函数转换示例 #

假设原CommonJS中间件代码：

const cloudinary = require('cloudinary').v2;
const multer = require('multer');
const { CloudinaryStorage } = require('multer-storage-cloudinary');

cloudinary.config({
  cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
  api_key: process.env.CLOUDINARY_API_KEY,
  api_secret: process.env.CLOUDINARY_API_SECRET
});

const storage = new CloudinaryStorage({
  cloudinary: cloudinary,
  params: {
    folder: 'uploads',
    allowed_formats: ['jpg', 'png']
  }
});

const upload = multer({ storage: storage });
module.exports = upload.single('image');

转换为ES模块版本：

import { v2 as cloudinary } from 'cloudinary';
import multer from 'multer';
import { CloudinaryStorage } from 'multer-storage-cloudinary';
import dotenv from 'dotenv';

dotenv.config(); // 若使用.env文件，需显式调用

cloudinary.config({
  cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
  api_key: process.env.CLOUDINARY_API_KEY,
  api_secret: process.env.CLOUDINARY_API_SECRET
});

const storage = new CloudinaryStorage({
  cloudinary: cloudinary,
  params: {
    folder: 'uploads',
    allowed_formats: ['jpg', 'png']
  }
});

const upload = multer({ storage: storage });
export default upload.single('image');

2. uploadRouter.js转换示例 #

原CommonJS路由代码：

const express = require('express');
const uploadMiddleware = require('../middleware/uploadMiddleware');
const router = express.Router();

router.post('/', uploadMiddleware, (req, res) => {
  res.json({ url: req.file.path });
});

module.exports = router;

转换为ES模块版本：

import express from 'express';
import uploadMiddleware from '../middleware/uploadMiddleware.js'; // 必须加.js扩展名
const router = express.Router();

router.post('/', uploadMiddleware, (req, res) => {
  res.json({ url: req.file.path });
});

export default router;

3. server.js调用转换示例 #

原CommonJS调用代码：

const express = require('express');
const uploadRouter = require('./routes/uploadRouter');
const app = express();

app.use('/api/upload', uploadRouter);

app.listen(3000, () => console.log('Server running on port 3000'));

转换为ES模块版本：

import express from 'express';
import uploadRouter from './routes/uploadRouter.js'; // 必须加.js扩展名
const app = express();

app.use('/api/upload', uploadRouter);

app.listen(3000, () => console.log('Server running on port 3000'));

额外注意事项 #

• 确保package.json中已设置"type": "module"
• 所有依赖包需支持ES模块，若遇到不兼容的包，可尝试安装其ES版本或使用import()动态导入
• 若使用__dirname/__filename，ES模块中需手动实现：

  import { fileURLToPath } from 'url';
  import { dirname } from 'path';
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = dirname(__filename);
  

内容的提问来源于stack exchange，提问作者Stephen Scott Moore