Jenkins Kubernetes Agent中user.home与user.name显示问号原因排查

问题场景 #

在Kubernetes环境的Jenkins Agent中，使用container("...")语法运行Gradle构建任务时，出现Java系统属性user.home和user.name被解析为?的异常情况，导致依赖用户主目录的业务代码生成了包含?的畸形文件名。当前输出的系统属性信息如下：

user.home: ?
user.language: en
user.name: ?

可能导致问题的场景 #

• 当前运行用户UID未在容器/etc/passwd中存在：Java获取user.name和user.home时，会通过系统调用读取容器内的/etc/passwd文件，匹配当前进程的UID。如果Jenkins Agent运行时使用的UID（比如默认的非root用户UID）没有在镜像的/etc/passwd中配置对应条目，Java无法解析出有效的用户名和主目录，就会返回?。
• Jenkins Agent配置强制覆盖用户属性：部分自定义的Jenkins Agent启动参数、环境变量设置，可能直接修改了Java系统属性，或者通过调整进程运行上下文，导致Java无法正常读取系统用户信息。
• 容器镜像的用户配置异常：如果镜像未正确创建用户目录、用户权限被错误修改，或者使用USER指令指定了一个不存在的用户，都会导致Java无法获取有效的用户环境信息。
• Kubernetes Pod安全上下文配置错误：若Pod的securityContext中设置了runAsUser为镜像中未定义的UID，且未配套配置runAsGroup或supplementalGroups来补全用户上下文，进程会运行在无对应用户条目的环境中，触发Java属性解析异常。

内容的提问来源于stack exchange，提问作者Thorbjørn Andersen - UFST