在cyclic.sh部署含multer的Node.js后端遇EROFS错误，求存储方案

Cyclic.sh的文件系统是只读的，本地uploads目录无法写入，必须用它提供的S3存储桶来保存文件。下面给出两种可行的实现方案，以及常见问题排查思路：

一、用@cyclic.sh/s3fs正确配置文件存储 #

如果之前配置失败，大概率是存储引擎没对接对，按以下步骤来：

1. 安装依赖

npm install @cyclic.sh/s3fs multer

2. 编写上传接口代码
   不需要手动配置AWS密钥，Cyclic会自动把相关环境变量注入项目：

const express = require('express');
const multer = require('multer');
const S3FS = require('@cyclic.sh/s3fs').default;

const app = express();
// 替换成你Cyclic控制台里的桶名称
const s3fs = new S3FS('your-cyclic-bucket-name');

// 用内存暂存文件，避免写入本地只读文件系统
const storage = multer.memoryStorage();
const upload = multer({ storage: storage });

// 处理音频上传的接口
app.post('/upload-audio', upload.single('audio'), async (req, res) => {
  try {
    if (!req.file) {
      return res.status(400).send('未上传文件');
    }

    // 加时间戳避免文件名重复，用audio/前缀分类存储
    const fileName = `audio/${Date.now()}-${req.file.originalname}`;
    // 写入S3桶，同时指定文件MIME类型
    await s3fs.writeFile(fileName, req.file.buffer, {
      ContentType: req.file.mimetype
    });

    // 生成文件访问地址（默认公开可读）
    const fileUrl = `https://${s3fs.bucket}.s3.amazonaws.com/${fileName}`;
    res.status(200).json({ message: '上传成功', url: fileUrl });
  } catch (err) {
    console.error(err);
    res.status(500).send('上传失败');
  }
});

app.listen(process.env.PORT || 3000, () => {
  console.log('服务启动');
});

3. 注意事项

• 确保Cyclic控制台的S3存储功能已开启（默认是启用状态）
• 若要存私有文件，在writeFile时添加ACL: 'private'参数，后续需用签名URL访问

二、替代方案：直接用AWS SDK v3操作S3 #

如果@cyclic.sh/s3fs仍有问题，可直接调用AWS官方SDK：

1. 安装依赖

npm install @aws-sdk/client-s3 @aws-sdk/lib-storage multer

2. 编写上传代码

const express = require('express');
const multer = require('multer');
const { S3Client, PutObjectCommand } = require('@aws-sdk/client-s3');

const app = express();
// 自动读取Cyclic注入的环境变量
const s3Client = new S3Client({
  region: process.env.CYCLIC_REGION || 'us-east-1'
});

const storage = multer.memoryStorage();
const upload = multer({ storage: storage });

app.post('/upload-audio', upload.single('audio'), async (req, res) => {
  try {
    if (!req.file) {
      return res.status(400).send('未上传文件');
    }

    const fileName = `audio/${Date.now()}-${req.file.originalname}`;
    const uploadParams = {
      Bucket: process.env.CYCLIC_BUCKET_NAME, // Cyclic自动注入的桶名
      Key: fileName,
      Body: req.file.buffer,
      ContentType: req.file.mimetype,
      ACL: 'public-read' // 可选private设置私有
    };

    await s3Client.send(new PutObjectCommand(uploadParams));
    const fileUrl = `https://${process.env.CYCLIC_BUCKET_NAME}.s3.amazonaws.com/${fileName}`;
    res.status(200).json({ message: '上传成功', url: fileUrl });
  } catch (err) {
    console.error(err);
    res.status(500).send('上传失败');
  }
});

app.listen(process.env.PORT || 3000, () => {
  console.log('服务启动');
});

常见问题排查 #

• 检查环境变量：在Cyclic控制台的项目设置里，确认CYCLIC_BUCKET_NAME、AWS密钥等变量是否存在
• 看错误日志：Cyclic项目控制台的日志里会有具体错误信息，比如桶名写错、权限不足、文件大小超限（默认单文件最大5GB）

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