NextJS+Bazel构建报错：无法解析tsconfig路径映射模块

针对你遇到的@/app/_lib/utils模块找不到的问题，从Bazel与TS规则的适配逻辑出发，给你几个可行的排查和解决方向：

1. 同步tsconfig.json与ts_project的paths映射 #

aspect-build的ts_project不会完全复用tsconfig里的paths配置，需要在BUILD文件中显式声明别名映射，确保Bazel的模块解析器能识别@/开头的路径：

ts_project(
    name = "your_ts_target",
    srcs = glob(["app/**/*.ts", "app/**/*.tsx", "lib/**/*.ts"]),
    tsconfig = "//:tsconfig.json",
    # 重点：添加paths字段与tsconfig对应
    paths = {
        "@/app/*": ["./app/*"],
        "@/lib/*": ["./lib/*"] # 如果有其他别名也要同步
    },
    deps = [
        # 你的依赖，比如//node_modules/react之类的
    ],
)

同时调整tsconfig.json的paths，覆盖源文件和Bazel输出目录（避免TS语法检查报错）：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/app/*": ["./app/*", "bazel-out/*/bin/app/*"],
      "@/lib/*": ["./lib/*", "bazel-out/*/bin/lib/*"]
    }
  }
}

2. 验证Bazel输出目录的文件结构 #

执行bazel build //your:target后，查看bazel-out/<config>/bin/app/_lib/目录下是否存在编译后的utils.js/utils.d.ts文件。如果缺失，说明：

• 要么srcs没包含app/_lib/utils.ts，检查glob规则是否覆盖到该文件；
• 要么依赖链有问题，比如该文件被其他target引用但没正确声明依赖。

3. 切换到aspect-build的rules_nextjs（推荐） #

直接用ts_project适配NextJS App Router会有很多兼容性问题，aspect-build官方提供了rules_nextjs，专门处理NextJS的构建逻辑，包括路径别名、App Router的文件约定等。替换为以下配置：

load("@aspect_rules_nextjs//nextjs:defs.bzl", "nextjs_build")

nextjs_build(
    name = "next",
    srcs = glob(["app/**/*", "public/**/*", "next.config.js"]),
    tsconfig = "//:tsconfig.json",
    deps = [
        # 你的依赖
    ],
)

这个规则会自动识别tsconfig里的paths，无需手动在BUILD里重复配置。

4. 检查baseUrl的正确性 #

确保tsconfig的baseUrl设为.（项目根目录），否则paths的相对路径会基于错误的基准目录，导致TS和Bazel都无法正确解析别名。

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