Tomcat admin-gui登录失败求助：配置tomcat-users.xml后无法登录

以下是针对配置后无法登录的常见解决步骤：

1. 修复XML标签语法错误 #

你给出的配置缺少XML标签的闭合标记，Tomcat无法识别不完整的XML节点。正确的配置格式应该是：

<role rolename="admin-gui"/>
<user username="joe" password="jungle13" roles="manager-gui,admin-gui"/>

确保tomcat-users.xml中的所有标签都严格遵循XML语法，没有遗漏<、>或/>。

2. 确认配置文件路径正确 #

• 直接修改Tomcat安装目录下conf/tomcat-users.xml，不要修改IDE项目中的副本（除非你确认IDE关联的是这个目录的Tomcat实例）
• 检查Tomcat启动日志，确认加载的是你修改的配置文件路径

3. 必须重启Tomcat #

修改tomcat-users.xml后，Tomcat不会自动加载新配置，必须完全停止并重新启动服务，确保新的用户角色配置生效。

4. 匹配角色与访问页面 #

• admin-gui角色对应访问 Host Manager（路径/host-manager/html）
• manager-gui角色对应访问 Manager App（路径/manager/html）
  确认你登录的页面和配置的角色权限对应，比如访问Host Manager需要admin-gui，访问应用管理需要manager-gui。

5. 清除浏览器缓存或使用隐身模式 #

浏览器可能缓存了旧的登录信息，导致新的账号无法验证。尝试清除浏览器缓存，或者使用隐身窗口重新输入账号密码登录。

6. 检查IP访问限制（Tomcat 8+） #

部分Tomcat版本默认限制管理页面仅允许本地IP访问。若你从远程或非本地IP访问，需要修改conf/Catalina/localhost/manager.xml和host-manager.xml中的RemoteAddrValve配置：
例如，将allow属性修改为允许你的IP，或者临时设置为allow=".*"（仅用于测试，生产环境需严格限制IP）：

<Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="你的IP地址|127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />

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