打包@tensorflow/tfjs-node时出现mock-aws-s3依赖要求问题排查

为什么打包后会出现这个问题？ #

• TensorFlow.js的Node.js版本（比如@tensorflow/tfjs-node）内置条件导入逻辑：部分和云存储相关的模块只会在特定环境或触发特定功能时才加载。tsc编译仅做代码转译，不会静态扫描所有可能的导入分支，所以运行时未用到的分支不会触发依赖加载；但esbuild/rollup这类打包工具是静态分析全代码库，会把所有条件分支里的导入都判定为必要依赖，哪怕你实际运行时根本用不到，因此出现了原本不存在的mock-aws-s3依赖报错。
• 部分旧版本tfjs在Node.js环境下的条件判断逻辑存在缺陷，导致打包工具误将测试用的mock包识别为生产依赖。

解决方法 #

1. 给打包工具配置外部依赖排除 #

针对esbuild，在构建配置中添加：

// esbuild.config.js
require('esbuild').build({
  // 其他配置项...
  external: ['mock-aws-s3'],
})

针对rollup，在配置文件的external数组中加入该模块：

// rollup.config.js
export default {
  // 其他配置项...
  external: ['mock-aws-s3'],
}

配置后打包工具会跳过该模块的打包，运行时Node.js会自动忽略未用到的依赖。

2. 用环境变量跳过不必要的代码分支 #

通过替换环境变量，让打包工具识别无需编译tfjs中的S3相关分支：

• esbuild可使用define配置：

require('esbuild').build({
  define: {
    'process.env.TFJS_DISABLE_S3': 'true',
  },
})

• rollup可借助@rollup/plugin-replace插件：

import replace from '@rollup/plugin-replace';

export default {
  plugins: [
    replace({
      'process.env.TFJS_DISABLE_S3': 'true',
      preventAssignment: true,
    }),
  ],
}

3. 升级或更换TensorFlow.js包 #

• 升级@tensorflow/tfjs-node至最新稳定版，新版本已修复这类打包依赖误判问题。
• 确认安装的是适配Node.js环境的包：使用@tensorflow/tfjs-node而非浏览器版@tensorflow/tfjs，避免引入不必要的浏览器端依赖分支。

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