Azure Functions中通过NodeJS生成Excel出现Content-Length错误求解

错误原因 #

• azure-function-express适配器对二进制流响应的适配存在缺陷，当你直接把express响应对象传给excel4node的write方法做流式写入时，适配器会提前计算错误的Content-Length值，和实际写入的Excel字节数不一致，触发Azure Functions底层Kestrel服务器的校验报错。

解决方案 #

方案1：改造现有express写法，改用Buffer返回 #

不使用流式写入，先通过writeToBuffer方法拿到完整的Excel Buffer，再手动设置响应头返回，避免长度预估错误：

const createHandler =  require('azure-function-express').createHandler;
const express = require('express');
const xl = require('excel4node')
const app = express();
app.post('/api/hello-world', async (req, res) => {
    try {
        const wb = new xl.Workbook();
        const ws = wb.addWorksheet('S');
        ws.cell(1, 1).string('A');
        // 生成完整Buffer再返回
        const excelBuffer = await wb.writeToBuffer();
        res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
        res.setHeader('Content-Disposition', 'attachment; filename="FileName.xlsx"');
        res.send(excelBuffer);
    } catch (err) {
        res.status(500).send('Excel生成失败：' + err.message);
    }
});
module.exports = createHandler(app);

方案2：使用原生Azure Functions HTTP触发器（更推荐） #

直接弃用azure-function-express适配器，使用原生写法绕开适配问题，稳定性更高：
首先配置触发器配置文件function.json：

{
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    }
  ]
}

然后编写入口文件index.js：

const xl = require('excel4node');
module.exports = async function (context, req) {
    try {
        const wb = new xl.Workbook();
        const ws = wb.addWorksheet('S');
        ws.cell(1, 1).string('A');
        const excelBuffer = await wb.writeToBuffer();
        context.res = {
            headers: {
                'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
                'Content-Disposition': 'attachment; filename="FileName.xlsx"'
            },
            body: excelBuffer
        };
    } catch (err) {
        context.res = {
            status: 500,
            body: 'Excel生成错误：' + err.message
        };
    }
};

注意事项 #

• 部署前确保excel4node依赖已经正确安装到项目node_modules目录，随代码一同打包上传到Azure Functions。
• 生成大体积Excel时可适当调高Azure Functions的执行超时时间和内存配额，避免执行中断。

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