如何修复Linux下Node.js Azure Functions的invalid ELF header报错

问题现象 #

部署运行于Linux环境的v3版本Node.js Azure Functions完成后，接口返回500错误，错误日志详情为：
Error: /home/site/wwwroot/node_modules/canvas/build/Release/canvas.node: invalid ELF header

触发条件 #

该错误仅在项目引入如下代码时触发：

import ChartDataLabels from 'chartjs-plugin-datalabels';
const canvasRenderService = new CanvasRenderService(width, height, chartCallback);

const chartCallback = (ChartJS) => {
    ChartJS.register(require('chartjs-plugin-datalabels'))
};
const jsdom = require("jsdom");
const { JSDOM } = jsdom;
const { document } = (new JSDOM(`...`)).window;

该项目在本地开发环境运行完全正常，仅部署到Azure后出现报错。

错误根因 #

canvas属于包含原生编译逻辑的npm依赖包，本地开发环境如果是Windows或macOS系统，执行npm install时会编译生成适配当前本地系统架构的二进制文件，而Azure Functions Linux运行环境的系统架构与本地不一致，无法识别其他系统编译生成的二进制文件，因此抛出无效ELF头错误。

解决方案 #

使用Linux环境安装依赖后再执行部署即可解决该问题，最简便的操作方式如下：

• 在Windows设备上打开Linux子系统（WSL），拉取项目最新代码
• 在WSL终端中进入项目目录，执行npm install安装所有依赖
• 直接在WSL终端中执行Azure Functions部署操作即可
  也可以使用基于Linux运行器的CI/CD流水线完成依赖安装、打包、部署全流程，效果一致。

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