Mac M1 Docker amd64仿真环境下，非root用户Bazel无法连接本地服务器

可能的原因 #

• Qemu仿真下的Unix Socket权限异常：Bazel通过Unix Socket与本地服务器通信，默认socket文件存储在用户缓存目录（~/.cache/bazel/_bazel_<user>/server/server.socket）。在Qemu跨平台仿真环境中，容器内非root用户的socket文件可能因用户命名空间映射问题，出现权限校验失败，而root用户不受该限制。
• 仿真性能瓶颈引发超时：Mac M1上通过Qemu仿真amd64架构存在性能损耗，非root用户的资源优先级较低，导致Bazel服务器启动速度过慢，超过默认120秒的连接超时阈值。--batch模式不启动常驻服务器，直接单进程执行任务，因此不受影响；root用户通常拥有更高资源优先级，服务器启动速度能达标。
• Docker用户命名空间隔离偏差：Docker的用户命名空间映射在跨平台场景下可能出现异常，容器内非root用户的UID与宿主机UID匹配错误，导致socket文件的权限检查不通过。

排查与解决步骤 #

1. 检查Socket文件权限

   • 切换到非root用户，执行Bazel命令后，查看缓存目录下的socket文件：

     ls -l ~/.cache/bazel/_bazel_$(whoami)/server/server.socket
     

   • 对比root用户下的socket权限（sudo ls -l ~root/.cache/bazel/_bazel_root/server/server.socket），若非root用户的socket权限不是rw-------（当前用户可读可写），手动调整权限：

     chmod 600 ~/.cache/bazel/_bazel_$(whoami)/server/server.socket
     

2. 指定自定义Socket路径
   将socket文件放在全局可写的临时目录，规避用户缓存目录的权限问题：

   bazel build --socket_path=/tmp/bazel-server.sock //your-target
   

3. 提升资源优先级与分配

   • 给非root用户的Bazel进程提升CPU优先级：

     nice -n -10 bazel build //your-target
     

   • 启动Docker容器时增加CPU和内存分配，提升仿真性能：

     docker run --platform=linux/amd64 --cpus=4 --memory=8g -it your-ubuntu-image
     

4. 延长连接超时时间
   若因服务器启动过慢导致超时，延长连接超时阈值：

   bazel build --connect_timeout=300 //your-target
   

5. 调整Docker用户命名空间设置
   临时禁用Docker用户命名空间隔离（注意安全风险，仅用于排查）：

   docker run --platform=linux/amd64 --userns=host -it your-ubuntu-image
   

6. 增加Bazel服务器内存分配
   通过环境变量给Bazel服务器分配更多内存，加快启动速度：

   export BAZEL_OPTS="--host_jvm_args=-Xmx4g"
   bazel build //your-target
   

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