导入tfjs-node时出现报错与警告的原因及解决咨询

执行以下代码时出现4个编译警告：

import * as tfn from '@tensorflow/tfjs-node'

警告信息：

WARNING  Compiled with 4 warnings                                                                                                                                                                 15:06:46  
warning  in ./node_modules/@tensorflow/tfjs-node/dist/index.js    
Critical dependency: the request of a dependency is an expression    
warning  in ./node_modules/@mapbox/node-pre-gyp/lib/util/compile.js   
Module not found: Error: Can't resolve 'node-gyp' in 'C:\Users\Username\Desktop\Team\my-app\node_modules\@mapbox\node-pre-gyp\lib\util'   
warning  in ./node_modules/@mapbox/node-pre-gyp/lib/util/compile.js    
Module not found: Error: Can't resolve 'npm' in 'C:\Users\Username\Desktop\Team\my-app\node_modules\@mapbox\node-pre-gyp\lib\util'   
warning  in ./node_modules/@mapbox/node-pre-gyp/lib/util/nw-pre-gyp/index.html

Module parse failed: Unexpected token (1:0)
You may need an appropriate loader to handle this file type, currently no loaders are configured to process this file. See https://webpack.js.org/concepts#loaders
> <!doctype html>

环境信息 #

• Vue版本：2.7.8
• Webpack配置文件webpack.config.js内容：

const path = require('path');
const nodeExternals = require('webpack-node-externals');

module.exports = {
  entry: './server.js',
  mode: 'production',
  target: 'node',
  externals: [nodeExternals()],
  output: {
    path: path.resolve(__dirname, '.'),
    filename: 'server.bundle.js'
  }
};

• 相关包版本：

├── @tensorflow/tfjs-converter@3.19.0
├── @tensorflow/tfjs-core@3.19.0
├── @tensorflow/tfjs-node@3.19.0
├── @tensorflow/tfjs@3.19.0
├── aws-sdk@2.1195.0

额外尝试 #

通过Windows Subsystem for Linux（WSL）安装时出现错误：

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! @tensorflow/tfjs-node@3.19.0 install: `node scripts/install.js`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the @tensorflow/tfjs-node@3.19.0 install script.

1. 动态依赖警告：@tensorflow/tfjs-node内部使用了动态路径的require调用，Webpack无法静态分析这类依赖，因此抛出Critical dependency警告。
2. 系统工具被当作模块解析：@mapbox/node-pre-gyp是tfjs-node的依赖，它需要系统环境中的node-gyp和npm作为可执行工具，但Webpack错误地将它们当作普通Node模块解析，导致找不到。
3. HTML文件无对应loader：Webpack默认未配置处理HTML文件的loader，@mapbox/node-pre-gyp目录中的index.html被纳入编译流程，导致解析失败。
4. WSL编译依赖缺失：tfjs-node安装时需要编译原生二进制文件，WSL环境缺少Python、C++编译器等必要编译工具，导致安装脚本执行失败。

解决Webpack编译警告 #

1. 配置HTML loader并忽略系统工具模块：修改Webpack配置，添加HTML文件处理规则，同时让Webpack忽略node-gyp和npm的模块解析：

module.exports = {
  // 原有配置保留
  entry: './server.js',
  mode: 'production',
  target: 'node',
  externals: [nodeExternals()],
  output: {
    path: path.resolve(__dirname, '.'),
    filename: 'server.bundle.js'
  },
  // 新增配置
  module: {
    rules: [
      {
        test: /\.html$/,
        use: ['html-loader']
      }
    ],
    // 关闭动态依赖的警告提示
    exprContextCritical: false
  },
  resolve: {
    fallback: {
      'node-gyp': false,
      'npm': false
    }
  }
};

2. 优化externals配置：确保nodeExternals完全排除node_modules中的依赖，避免Webpack编译包含原生模块的tfjs-node：

externals: [nodeExternals({
  allowlist: [] // 不允许任何外部包被编译
})]

解决WSL安装失败 #

1. 安装编译依赖：在WSL终端执行以下命令：

sudo apt-get update
sudo apt-get install -y python3 make g++

2. 重新安装tfjs-node：

npm uninstall @tensorflow/tfjs-node
npm install @tensorflow/tfjs-node --build-from-source

额外建议 #

• 升级tfjs-node版本：3.19.0属于较旧版本，存在已知的安装和编译问题，升级到最新稳定版可避免部分兼容问题。
• 匹配Node.js版本：tfjs-node对Node.js版本有要求，建议使用16.x或18.x等LTS版本。

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