使用Cyclic.sh部署Node.js后端存储图片遇500错误求助

问题本质 #

Cyclic.sh的运行环境采用只读文件系统设计，你尝试直接写入本地images目录的操作不符合平台限制，这就是Error: EROFS: read-only file system报错的核心原因。

可行解决方案 #

1. 切换到Cyclic内置对象存储处理文件上传 #

Cyclic提供了专门的存储服务替代本地文件存储，通过官方cyclic-storage包实现：

• 安装依赖：

  npm install cyclic-storage
  

• 修改上传处理逻辑，替换原有的fs.writeFile代码：

  const { Storage } = require('cyclic-storage');
  const storage = Storage(process.env.CYCLIC_BUCKET_NAME);
  const multer = require('multer');
  const upload = multer({ storage: multer.memoryStorage() });
  
  app.post('/upload', upload.single('image'), async (req, res) => {
    try {
      if (!req.file) {
        return res.status(400).json({ message: '未上传文件' });
      }
      // 将文件存入Cyclic存储
      const result = await storage.put(req.file.originalname, req.file.buffer, {
        contentType: req.file.mimetype
      });
      // 获取文件的在线访问URL
      const fileUrl = result.url;
  
      // 写入数据库：记录文件的在线URL而非本地路径
      // 示例：await yourDbClient.query('INSERT INTO images (url, filename) VALUES (?, ?)', [fileUrl, req.file.originalname]);
  
      res.status(200).json({ success: true, url: fileUrl });
    } catch (err) {
      console.error('上传失败:', err);
      res.status(500).json({ success: false, message: '服务器内部错误' });
    }
  });
  

2. 更新数据库写入逻辑 #

文件成功上传到对象存储后，将返回的在线URL写入数据库，而非原本的本地文件路径。这样前端可以直接通过该URL访问图片，和你之前访问已存图片的逻辑一致。

3. 移除本地存储相关代码 #

删除所有涉及创建images文件夹、写入本地文件的fs模块调用，避免再次触发只读文件系统限制。

验证步骤 #

1. 重新部署项目至Cyclic.sh
2. 测试图片上传，登录Cyclic控制台查看存储面板，确认文件已成功上传
3. 检查数据库，确认文件URL已正确写入
4. 访问返回的文件URL，验证图片可正常加载

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