Jenkins声明式流水线无法构建Docker镜像权限问题求助

我之前也碰到过一模一样的问题，核心原因其实很简单：你把jenkins用户加入docker组后，Jenkins服务进程没重启，导致它没读到最新的组权限。手动切换jenkins用户时是新开了会话，会加载最新的组信息，但Jenkins后台进程还是用的旧的环境权限。

快速解决步骤 #

1. 重启Jenkins服务
   这是最直接有效的办法，重启后Jenkins会重新读取用户的组配置。执行命令：

   sudo systemctl restart jenkins
   

   重启后再跑流水线，应该就能正常执行docker run这类命令了。

2. 验证权限是否生效
   重启后可以在流水线里加一步输出用户组信息确认：

   id jenkins
   

   输出里应该能看到docker组出现在生效的组列表中；或者手动登录jenkins用户执行同样命令，确认组权限已经加载。

3. 如果重启后仍有问题：检查Docker Socket权限
   偶尔会碰到Docker Socket的所属组不是docker的情况，执行以下命令查看：

   ls -l /var/run/docker.sock
   

   正常输出应该是这样的：

   srw-rw---- 1 root docker 0  ... /var/run/docker.sock
   

   如果不是，手动修正权限：

   sudo chown root:docker /var/run/docker.sock
   sudo chmod 660 /var/run/docker.sock
   

   改完后再次重启Jenkins服务即可。

为什么手动执行正常？ #

你手动切换到jenkins用户时，是开启了一个全新的shell会话，这个会话会重新读取/etc/group里的配置，所以能获取到docker组的权限；但Jenkins服务是在你添加用户到docker组之前启动的，它的进程环境里没有这个组的权限，所以流水线执行时就会触发权限拒绝错误。

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