如何在Bazel 0.11.1环境下修改bootclasspath？

我之前也踩过这个坑——直接用--javacopt=-bootclasspath确实不会生效，这是因为Bazel会主动接管Java编译环境的类路径配置，外部通过javacopt传入的bootclasspath参数会被它的默认JDK配置覆盖。要实现用Java 7的bootclasspath编译（彻底避免引入Java 8 API），正确的方式是通过自定义Java Toolchain来配置，而不是直接加javacopt参数。

下面是具体的实现步骤：

1. 把Java 7 JDK注册为Bazel外部依赖 #

首先在项目根目录的WORKSPACE文件中，将本地安装的Oracle Java 7添加为Bazel可识别的外部仓库：

new_local_repository(
    name = "java7_jdk",
    path = "/usr/lib/jvm/oracle-jdk-1.7.0",  # 替换成你的Java 7实际安装路径
    build_file_content = """
package(default_visibility = ["//visibility:public"])

filegroup(
    name = "rt.jar",
    srcs = ["jre/lib/rt.jar"],
)

filegroup(
    name = "jce.jar",
    srcs = ["jre/lib/jce.jar"],
)
""",
)

这里我们把Java 7核心的rt.jar和jce.jar打包成filegroup，方便后续在toolchain中引用。

2. 定义Java 7专属的Toolchain #

在项目根目录（或者专门的tools/jdk目录）创建一个BUILD文件，编写自定义toolchain配置：

java_toolchain(
    name = "java7_toolchain",
    source_version = "7",
    target_version = "7",
    # 指定Java 7的核心类库作为bootclasspath
    bootclasspath = ["@java7_jdk//:rt.jar", "@java7_jdk//:jce.jar"],
    # 可选：添加你需要的其他编译参数
    # javacopts = ["-Xlint:unchecked", "-Xlint:deprecation"],
)

这个配置会明确告诉Bazel：使用Java 7的源码/字节码版本，并且严格以Java 7的核心类库作为编译时的bootclasspath。

3. 让Bazel默认使用这个Toolchain #

在你的.bazelrc文件中添加以下配置，让所有构建任务默认采用这个Java 7 toolchain：

build --java_toolchain=//:java7_toolchain
build --host_java_toolchain=//:java7_toolchain

如果只想针对特定构建目标临时使用，也可以在命令行中指定：

bazel build --java_toolchain=//:java7_toolchain //your/package:target

为什么直接用--javacopt=-bootclasspath无效？ #

Bazel在编译Java代码时，会根据内部的javabase配置（默认是主机上的JDK）自动生成bootclasspath参数。你通过--javacopt传入的-bootclasspath会被Bazel自动生成的参数覆盖，所以根本不会生效。而通过java_toolchain配置的bootclasspath，会被Bazel优先采用，完全替代默认的bootclasspath设置。

这样设置后，编译出的.class文件不仅会兼容Java 7的字节码版本，还会严格限制只能使用Java 7的API，彻底避免引入Java 8特有的依赖，完全符合最佳实践要求。

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