存储IPFS文件调用res.send()推前端失败 报响应头已发送错误

• 直接触发报错的原因：单个HTTP请求仅允许返回一次响应，你的代码里先调用res.send(fileHash)向客户端发送了响应、响应头已经发送完成，之后又调用res.render()尝试再次设置响应头、返回渲染后的页面内容，必然触发"Cannot set headers after they are sent to the client"错误。
• 异步逻辑写法错误：saveFile是async异步函数，调用时没有加await，赋值给fileHash的只是一个pending状态的Promise对象，根本拿不到IPFS实际返回的文件哈希；同时saveFile内部混用了await和回调写法，给ipfs.add传回调后该方法不会返回Promise，await无法等待存储操作执行完成，且函数内没有return返回值，就算加了await也拿不到正确结果。
• 存储内容错误：你传给ipfs.add的是JSON.stringify(file)序列化后的文件元信息字符串，不是文件本身的二进制内容，就算存储成功，后续从IPFS读取到的也只是一串对象序列化文本，无法还原为原始文件。

• 同一请求内仅保留一个响应方法：如果需要返回JSON数据就只用res.send，如果需要返回渲染后的模板页面就只用res.render，禁止连续调用多个响应方法。
• 修正异步逻辑：统一ipfs.add的写法，不要混用await和回调，确保saveFile能正确返回IPFS生成的文件哈希，调用时必须加await等待异步操作完成。
• 传入正确的文件内容：从上传的file对象中取实际的二进制Buffer内容传给IPFS，不要序列化整个file对象。
• 增加异常捕获，避免存储出错时请求挂起。

修复后的参考代码：

async function saveFile(fileContent) {
    // 统一用await写法，不传回调，拿到IPFS返回结果
    const result = await ipfs.add(fileContent);
    console.log('IPFS存储结果：', result);
    // 返回IPFS生成的文件哈希（旧版SDK对应result.path，新版可根据实际返回字段取result.cid.toString()）
    return result.cid ? result.cid.toString() : result.path;
}

app.post('/upload', async (req, res) => {
    try {
        const file = req.files.file;
        const fileName = req.body.fileName;
        // 加await等待存储完成，传入文件实际二进制内容（express-fileupload等中间件默认存在file.data字段）
        const fileHash = await saveFile(file.data);
        
        // 二选一即可，不要同时调用
        // 场景1：返回渲染后的上传结果页
        res.render('pages/upload.ejs', { fileName, fileHash });
        // 场景2：接口返回JSON数据
        // res.send({ code: 0, data: { fileName, fileHash }, msg: '上传成功' });
    } catch (err) {
        console.error('上传失败：', err);
        res.status(500).send({ code: -1, msg: '文件上传失败' });
    }
});

如果使用的是仅支持回调风格的旧版IPFS SDK，可以去掉async/await，直接在ipfs.add的回调内处理结果、返回响应即可，注意不要在回调外提前调用res.send/res.render。

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