NX单体仓库中单独编译文件以使用Bullmq沙箱任务的方案问询

方案1：新增单独的TSC编译目标 #

NX默认打包会合并文件，你可以给项目加一个专门编译任务处理器的目标，用tsc单独输出单个文件：

1. 在项目的project.json里添加build-handlers目标：

{
  "targets": {
    "build-handlers": {
      "executor": "@nrwl/js:tsc",
      "options": {
        "tsConfig": "apps/your-server/tsconfig.handlers.json",
        "outputPath": "dist/apps/your-server/handlers",
        "main": "apps/your-server/src/handlers/**/*.ts",
        "watch": false
      }
    }
  }
}

2. 新建tsconfig.handlers.json，继承项目根配置，指定仅编译处理器目录并保留模块结构：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "module": "CommonJS", // 适配Bullmq沙箱的CommonJS环境
    "outDir": "../../dist/apps/your-server/handlers",
    "rootDir": "./src/handlers"
  },
  "include": ["src/handlers/**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

3. 运行nx build-handlers your-server，就能在dist/apps/your-server/handlers下拿到单个编译好的.js文件，直接给Bullmq沙箱引用。

方案2：用自定义命令执行TSC编译 #

如果NX的executor不够灵活，用run-commands直接调用tsc命令，方便自定义参数：
在project.json中添加：

{
  "targets": {
    "build-handlers": {
      "executor": "@nrwl/workspace:run-commands",
      "options": {
        "commands": [
          "tsc --project apps/your-server/tsconfig.handlers.json"
        ],
        "parallel": false
      }
    }
  }
}

要是内部库导入路径有问题，在tsconfig.handlers.json里配置paths映射，比如：

"compilerOptions": {
  "paths": {
    "@your-monorepo/utils": ["../../libs/utils/src/index.ts"]
  }
}

确保编译后的文件能正确找到依赖。

方案3：将处理器拆为独立NX项目 #

把任务处理器单独做成一个NX库或应用，让它的构建完全独立，从根源解决导入问题：

1. 创建新库：nx generate @nrwl/js:lib task-handlers
2. 在这个库的project.json里配置构建目标，用tsc编译成模块结构（而非单文件）
3. 主服务器项目依赖这个库，构建时NX会自动先构建task-handlers，之后你直接引用dist/libs/task-handlers/src/handler.js作为沙箱路径即可。

方案4：修改主构建配置，单独输出处理器文件 #

如果不想额外构建步骤，修改主项目的webpack/esbuild配置，把处理器文件排除在主包外，单独输出：
以webpack为例，在apps/your-server/webpack.config.js中修改：

const path = require('path');
const glob = require('glob');

module.exports = (config) => {
  // 单独处理handlers目录的文件，输出到指定路径
  config.entry = {
    ...config.entry,
    ...Object.fromEntries(
      glob.sync('./src/handlers/**/*.ts').map(file => [
        file.replace('./src/handlers/', 'handlers/').replace('.ts', ''),
        file
      ])
    )
  };
  config.output.filename = '[name].js';
  return config;
};

这样主构建时会把每个处理器文件单独输出到dist/apps/your-server/handlers下，主包不会包含这些代码。

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