在Bazel中执行Java程序并写入其文件结构的问题咨询

一、让Java程序在沙箱内正常运行 #

Bazel沙箱是隔离环境，所有依赖必须明确声明，不能直接引用外部bazel-bin路径，按以下步骤调整：

• 1. 正确传递输入文件与工具依赖
  不要硬编码bazel-bin/src/files，通过规则的属性收集输入文件，同时把Java jar声明为执行期工具：

  def _my_preprocess_rule_impl(ctx):
      # 从规则参数获取预编译输入文件
      input_files = ctx.files.srcs
      # 获取Java工具jar（需在BUILD中用java_binary或java_library构建）
      java_tool = ctx.executable._java_processor
  
      # 声明输出文件，Bazel会自动管理其在沙箱和外部的路径
      output_file = ctx.actions.declare_file(ctx.label.name + "_processed.txt")
  
      ctx.actions.run(
          inputs = input_files,
          outputs = [output_file],
          executable = java_tool,
          arguments = [
              # 传入沙箱内的输入文件路径
              ",".join([f.path for f in input_files]),
              # 传入沙箱内的输出文件路径
              output_file.path
          ],
      )
      return [DefaultInfo(files = depset([output_file]))]
  
  my_preprocess_rule = rule(
      implementation = _my_preprocess_rule_impl,
      attrs = {
          "srcs": attr.label_list(allow_files = True),
          # 标记为执行期工具，确保Bazel为沙箱环境构建它
          "_java_processor": attr.label(
              executable = True,
              cfg = "exec",
              allow_single_file = [".jar"],
              default = Label("//path/to/your:java_processor_jar"),
          ),
      },
  )
  

  关键注意点：

  • 用cfg="exec"标记Java工具，Bazel会适配执行环境构建它，保证沙箱内可运行。
  • 所有输入必须加入inputs参数，沙箱内无法直接访问外部bazel-bin的绝对路径。

• 2. 处理Java运行时依赖
  如果你的jar需要系统Java环境，要把Java运行时也加入依赖：

  attrs = {
      # ...其他属性
      "_java_runtime": attr.label(
          default = Label("@bazel_tools//tools/jdk:current_java_runtime"),
          cfg = "exec",
      ),
  }
  

  然后用Java命令启动jar：

  java_exe = ctx.executable._java_runtime
  ctx.actions.run(
      inputs = input_files + ctx.files._java_runtime,
      outputs = [output_file],
      executable = java_exe,
      arguments = [
          "-jar", java_tool.path,
          ",".join([f.path for f in input_files]),
          output_file.path
      ],
  )
  

二、让Java程序写入Bazel文件结构 #

Bazel禁止直接写入外部目录，所有输出必须通过ctx.actions.declare_file或ctx.actions.declare_directory声明：

• 你的Java程序只能写入ctx.action.run的outputs参数里的路径，这些路径是沙箱内的临时路径，Bazel会自动把生成的文件同步到外部的Bazel目录（比如bazel-bin下对应位置）。
• 不要让Java程序硬编码输出路径，必须接收ctx.action.run传递的output_file.path作为写入目标。

常见问题排查 #

• 出现"文件找不到"：检查所有输入文件是否都加入了inputs参数，是否用了file.path而非绝对路径。
• Java程序无法执行：确认jar是可执行的（或正确用Java命令启动），检查_java_processor的Label是否正确，是否设置了cfg="exec"。

内容的提问来源于stack exchange，提问作者Helí Rodríguez