使用Jenkins部署插件向远程Tomcat传WAR时凭证无效问题求助

碰到这种Tomcat凭证不被Jenkins识别的问题，大概率是配置细节没踩对，我给你梳理几个必查的关键点，一步步来排查：

这是最容易出错的地方，务必确保配置满足两个核心要求：

• 给用户分配**manager-script角色**（Jenkins部署用的是Tomcat的脚本管理API，不是网页GUI，所以这个角色是必需的；如果需要网页管理可以再加manager-gui）
• 账号密码完全正确，注意大小写、特殊字符有没有转义或者拼写错误

给你一个标准的配置示例，对照着检查：

<tomcat-users xmlns="http://tomcat.apache.org/xml"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"
              version="1.0">
  <!-- 其他配置... -->
  <user username="jenkins-deploy" password="YourSecurePass123" roles="manager-gui,manager-script"/>
</tomcat-users>

注意：配置必须放在<tomcat-users>标签内部，别不小心写到注释里或者标签外面了。

Tomcat默认对管理应用的访问有限制，得确认这几点：

• 检查Tomcat的webapps目录下有没有manager文件夹，如果没有，从Tomcat安装包的webapps.dist目录里复制manager过来（默认可能没部署）
• 如果存在conf/Catalina/localhost/manager.xml，检查里面的IP限制规则，把Jenkins服务器的IP加入允许列表。比如：

<Context docBase="${catalina.home}/webapps/manager" privileged="true" antiResourceLocking="false" antiJARLocking="false">
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.0\.0\.1|192\.168\.1\.100"/> <!-- 这里替换成Jenkins的IP -->
</Context>

如果没有这个文件，默认只允许本地访问，远程Jenkins就会被拒绝，需要添加这个文件开放权限。

不要直接在Jenkins里试，先在Jenkins服务器上用命令测试，排除Tomcat本身的问题：
执行这条curl命令（替换成你的账号、密码和Tomcat地址）：

curl -u jenkins-deploy:YourSecurePass123 http://your-tomcat-ip:8080/manager/text/list

如果返回类似OK - Listed applications for virtual host localhost和应用列表，说明凭证是好的；如果返回401 Unauthorized，那问题肯定在Tomcat配置上，和Jenkins无关。

Jenkins这边也容易犯小错误：

• 确保配置的是**「用户名和密码」类型**的凭证，别选成「Secret文本」或者其他类型
• 用户名和密码要和tomcat-users.xml里完全一致，哪怕是大小写错了都不行
• 在Deploy to Container插件的配置里，Tomcat的URL只需要填http://your-tomcat-ip:8080，不要加/manager后缀，插件会自动处理路径

很多人修改配置后随便重启一下，但Tomcat可能有残留进程导致配置没生效：

• 先执行shutdown.sh（或shutdown.bat）停止Tomcat
• 用ps aux | grep tomcat（Linux）或者任务管理器（Windows）检查有没有Tomcat进程残留，杀掉所有相关进程
• 再启动Tomcat，确保配置完全加载

如果上面的步骤都排查完还是不行，去看Tomcat的日志文件：

• 查看logs/catalina.out或localhost.log，里面会有更详细的错误信息，比如是权限不足、IP被拒绝还是凭证不匹配，根据日志再针对性调整。

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