Jenkins主目录从/var/lib/jenkins迁移至/data失败报错求助

你把Jenkins主目录从/var/lib/jenkins迁移到/data后碰到的CannotResolveClassException错误，核心是Jenkins找不到Role-Based Authorization Strategy插件的类文件，大概率和目录权限、隐藏文件遗漏、环境变量未正确加载有关，下面是针对性的解决步骤：

1. 修复迁移目录的权限 #

Jenkins默认以jenkins用户身份运行，必须确保新目录/data及其所有内容的所有权和权限符合要求：

# 递归设置所有者为jenkins用户和组
chown -R jenkins:jenkins /data
# 递归设置正确的读写权限
chmod -R 755 /data

2. 重新复制所有文件（包括隐藏文件） #

你之前用cp -R /var/lib/jenkins/* /data只会复制非隐藏文件，但Jenkins的关键配置（比如config.xml、插件目录的隐藏元数据）都是隐藏文件，要使用-a参数完整复制：

# 复制原主目录的所有内容（包括隐藏文件和属性）到新目录
cp -a /var/lib/jenkins/. /data/

-a参数会保留文件的权限、所有者信息，并且不会遗漏任何隐藏文件，是迁移目录的最佳选择。

3. 确保JENKINS_HOME环境变量生效 #

修改/etc/default/jenkins的配置是正确的，但必须重启Jenkins服务让配置生效：

systemctl restart jenkins

你可以通过以下命令验证Jenkins进程是否使用了新的JENKINS_HOME：

ps aux | grep jenkins | grep JENKINS_HOME

注意：/etc/profile.d/jenkins.sh和root用户.profile里的环境变量，通常不会被Jenkins服务进程读取（服务进程不加载用户profile），所以不要依赖这些配置，以/etc/default/jenkins里的设置为准。

4. 临时修复配置文件（紧急进入GUI） #

如果前面的步骤没解决，你可以临时修改/data/config.xml，把授权策略改成默认的，先进入Jenkins GUI再重新配置插件：
打开/data/config.xml，找到<authorizationStrategy>部分，替换成：

<authorizationStrategy class="hudson.security.FullControlOnceLoggedInAuthorizationStrategy">
  <denyAnonymousReadAccess>true</denyAnonymousReadAccess>
</authorizationStrategy>

保存后重启Jenkins，就能正常登录GUI，之后再重新安装或配置Role-Based Authorization Strategy插件。

5. 验证插件完整性 #

检查/data/plugins目录下是否存在role-strategy相关的JAR包和目录，如果缺失，从原目录复制并修复权限：

cp -a /var/lib/jenkins/plugins/role-strategy* /data/plugins/
chown jenkins:jenkins /data/plugins/role-strategy*

完成以上步骤后，再次重启Jenkins，应该就能解决这个解析错误了。

内容的提问来源于stack exchange，提问作者M. Max