PAYATHON 2026

Judge0 返回 null 且无法创建 box.c 文件,如何排查?

排障赵师傅

先排查 worker 的执行环境。API 能访问、提交能返回 token,说明请求已被接收,至于 worker 是否成功创建沙箱并执行代码,还需要查看执行状态和日志。

stdout、time、memory、stderr 全部为 null,无法单凭这些字段判断原因。既然出现了文件创建错误,应先获取完整日志,确认创建失败的文件路径和系统报错,再检查目录权限、挂载方式及沙箱初始化过程。目前还无法确定是否为 Docker 权限问题,也无法确认 box.c 的具体用途。

1. 查询提交状态,确认失败阶段

将命令中的 token 替换为实际提交返回的 token,查询状态和诊断字段:

curl -sS \
  "http://localhost:2358/submissions/some-token?base64_encoded=false&fields=token,status,stdout,stderr,compile_output,message,exit_code,time,memory"

重点查看以下字段:

  • status:确认提交处于排队、处理中、执行完成还是内部错误状态。
  • message:检查是否有执行基础设施或沙箱的错误信息。
  • compile_output:编译阶段失败时,错误信息可能出现在这里。
  • stderr:通常记录程序的标准错误输出;程序尚未启动时,可以为 null。

如果一直处于排队状态,检查 worker 是否启动,以及它与 Redis、数据库的连接是否正常。如果状态为内部错误,且日志中出现文件创建失败,就从这条错误继续排查。

wait=true 只用于等待结果,无法修复 worker 故障。排查时可以先异步提交,再按 token 查询,单独观察执行状态。

2. 获取完整日志,确认 box.c 的创建路径

以下命令假设 Compose 服务名为 worker。先确认实际服务名,再按部署情况替换后续命令中的名称:

docker compose config --services
docker compose ps
docker compose logs --tail=200 worker

接着跟踪日志,并提交一次最小测试:

docker compose logs -f worker

保留文件创建错误前后的日志,重点确认:

  • 文件的完整路径,以及名称是否确实为 box.c。
  • 原始报错,例如 Permission denied、No such file or directory、Read-only file system 或 No space left on device。
  • 文件创建错误之前,是否已有沙箱初始化、挂载或 cgroup 错误。
  • 错误对应的提交 token,避免混入其他任务的日志。

文件创建失败有时是前一步失败造成的。例如,沙箱初始化失败后,直到写入源文件时才报出目标目录不存在。遇到这种情况,应先修复最早出现的错误。

示例提交的是 JavaScript,仅凭文件名 box.c 无法判断它是否为本次提交的源文件。不要通过手动创建同名空文件来尝试修复。

3. 按系统错误检查文件系统

日志中的错误 优先检查
Permission denied 写入进程的 UID/GID、目录权限、父目录是否允许进入,以及宿主机安全策略
No such file or directory 父目录是否存在、沙箱是否初始化成功、路径或挂载目标是否配置错误
Read-only file system 容器根文件系统或相关挂载是否只读
No space left on device 磁盘容量、inode、临时文件系统容量
Operation not permitted 失败操作是否涉及挂载、namespace、cgroup 或容器安全限制

检查容器用户和挂载

WORKER_CONTAINER="$(docker compose ps -q worker)"

docker inspect "$WORKER_CONTAINER" \
  --format 'User={{.Config.User}} Privileged={{.HostConfig.Privileged}} ReadonlyRootfs={{.HostConfig.ReadonlyRootfs}}'

docker inspect "$WORKER_CONTAINER" \
  --format '{{json .Mounts}}'

docker compose exec worker sh -lc 'id; ps'

检查相关挂载的 Destination 是否覆盖日志中的目录,以及 RW 是否为 true。绑定挂载可能遮住镜像中原有的目录内容,而重建镜像不会改变宿主机目录的权限。

docker inspect 显示的用户和通过 docker compose exec 执行的 id 只能提供部分线索。如果 worker 启动后切换了用户,还需要确认实际写文件的进程身份。root 身份下写入成功,也不能证明 worker 用户有写入权限。

在实际父目录中测试写入

将下面的 UID:GID、服务名和目录替换为实际值,在本地排查环境中执行:

docker compose exec --user 'UID:GID' worker sh -lc '
  dir=/actual/parent/directory
  id
  ls -ld "$dir"
  df -h "$dir"
  df -i "$dir"
  probe=$(mktemp "$dir/.judge0-write-test.XXXXXX") || exit 1
  rm -- "$probe"
'

同时检查路径中的每一级父目录。在 Linux 中,即使目标目录允许写入,父目录缺少执行权限也可能导致路径访问失败。

这个测试只能验证指定身份在当前容器环境中的写入能力。沙箱可能使用独立的挂载和权限设置,即使测试成功,仍需结合沙箱日志判断。

根据检查结果,可以采取相应的修复措施:

  • 按实际进程的需要调整写入目录的归属和权限。
  • 修正错误的只读挂载,为临时工作目录提供可写空间。
  • 修复目录创建或沙箱初始化步骤。
  • 清理确认无用的临时文件,或增加相关存储容量。

不要直接对整个目录树执行 chmod -R 777,也不要通过删除数据库卷来尝试解决工作目录问题。

4. 检查 worker 与沙箱配置

如果日志显示挂载、namespace 或 cgroup 操作失败,应对照当前 Judge0 镜像版本配套的部署配置,逐项检查:

  • server 与 worker 是否使用预期的镜像和配置。
  • 是否改动过 worker 的 user、启动命令、卷或只读设置。
  • 是否遗漏了该版本部署文件要求的容器权限。
  • 是否使用 rootless Docker,或受到额外的容器安全策略限制。
  • 宿主机或 Docker 虚拟机的内核环境是否满足该版本的沙箱要求。

如果配套部署文件要求 worker 使用 privileged: true,需要确认实际容器是否按此配置创建。不要仅凭一条文件创建错误,就给所有服务增加特权或关闭安全限制。

涉及 SELinux、AppArmor 等限制时,先查看对应的拒绝日志,再修改具体规则或挂载设置。

修改 Compose 配置后,需要重新创建受影响的服务。单纯重启已有容器不会应用新的容器配置,例如:

docker compose up -d --force-recreate worker

5. 确认语言配置,并重新验证

先查看本机实例提供的语言列表:

curl -sS "http://localhost:2358/languages"

确认当前实例中的 language_id: 63 对应预期的 JavaScript 运行环境。如果不对应,改用列表中的实际 ID。

确认后,异步提交最小示例:

curl -sS -X POST \
  "http://localhost:2358/submissions?base64_encoded=false&wait=false" \
  -H "Content-Type: application/json" \
  -d '{
    "source_code": "console.log(1+1)",
    "language_id": 63
  }'

用返回的 token 查询状态。修复成功后,该示例应执行完成并输出 2。stderr 没有内容时仍可能为 null,因此不应要求所有字段都非 null 才算成功。

如果仍然失败,需要进一步查看完整错误行、文件绝对路径、Judge0 镜像标签、worker 的 Compose 配置和 Docker 运行环境。仅凭“无法创建 box.c”这一描述,还无法确定唯一的修复方案。

备注:内容仅供参考。