Node.js在Debian GNU/Linux 10.9运行时抛出Illegal instruction问题求助

问题根源 #

你的QEMU虚拟CPU（QEMU Virtual CPU version 2.5+）仅支持基础x86指令集（SSE/SSE2/PNI），而@tensorflow/tfjs-node的预编译二进制包默认针对支持AVX/AVX2等高级指令集的现代CPU构建，导致虚拟机执行时触发非法指令错误。

解决方案 #

方案1：开启虚拟机CPU的高级指令集支持（推荐）

修改KVM/QEMU虚拟机的CPU配置，让虚拟CPU继承宿主机指令集，或指定支持AVX2的CPU型号：

• 若使用virt-manager图形界面：编辑虚拟机配置 → CPU → 选择「Copy host CPU configuration」（复制宿主机CPU配置）
• 若使用命令行启动虚拟机：添加-cpu host参数，或指定具体CPU型号如-cpu Haswell

修改后重启虚拟机，重新安装依赖并运行代码即可。

方案2：改用纯JavaScript版本的TensorFlow.js

放弃依赖本地二进制的@tensorflow/tfjs-node，使用纯JS版@tensorflow/tfjs，完全在JS runtime中运行，避免指令集兼容问题：

1. 卸载现有依赖：

npm uninstall @tensorflow/tfjs-node @tensorflow/tfjs-core @tensorflow/tfjs-backend-cpu

2. 安装纯JS版依赖：

npm install @tensorflow/tfjs @tensorflow-models/qna

3. 修改代码的依赖引入部分：

// 替换原有的tfjs-node相关引入
import * as tf from '@tensorflow/tfjs';
const qna = require('@tensorflow-models/qna');

// 其余代码保持不变
const passage=`Super Bowl 50 was an American football game to determine the champion of the National Football League (NFL) for the 2015 season.
The American Football Conference (AFC) champion Denver Broncos defeated the National Football Conference (NFC) champion Carolina Panthers 24–10 to earn their third Super Bowl title. The game was played on February 7, 2016, at Levi's Stadium in the San Francisco Bay Area at Santa Clara, California.
As this was the 50th Super Bowl, the league emphasized the "golden anniversary" with various gold-themed initiatives, as well as temporarily suspending the tradition of naming each Super Bowl game with Roman numerals (under which the game would have  been known as "Super Bowl L"), so that the logo could prominently feature the Arabic   numerals 50.`

const qu= "Who won the Super Bowl?";

async function test(){
const model = await qna.load();
const answers = await model.findAnswers(qu, passage);
console.log('Answers: ');
console.log(answers);
}

test();

方案3：手动编译tfjs-node适配当前CPU（复杂）

若必须使用tfjs-node，可手动编译其依赖以适配虚拟CPU的指令集：

1. 安装编译依赖：

apt update && apt install build-essential python3 make gcc g++

2. 设置编译环境变量，让TensorFlow根据当前CPU指令集编译：

export CXXFLAGS="-march=native"
export CFLAGS="-march=native"

3. 删除现有依赖文件并重新安装：

rm -rf node_modules package-lock.json
npm install

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