Tomcat启动失败：tomcat-users.xml配置出现cvc-elt.1.a错误

问题根源 #

这个错误是XML解析器找不到<tomcat-users>根元素的Schema（XSD）定义导致的。哪怕你没手动修改配置，也可能因为这些隐性情况触发：

• 编辑器自动格式化、编码变更不小心破坏了文件开头的Schema声明
• Tomcat目录下的conf/schema文件夹丢失或文件损坏
• Eclipse的Tomcat配置缓存异常

修复步骤 #

1. 检查tomcat-users.xml的Schema声明 #

确保文件开头的XML头和Schema引用正确，以Tomcat 9为例，标准开头如下：

<?xml version="1.0" encoding="UTF-8"?>
<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">
  <!-- 你的用户、角色配置内容 -->
</tomcat-users>

• 注意xsi:schemaLocation的路径：若用相对路径，需保证tomcat-users.xsd和tomcat-users.xml在同一conf目录下；也可直接写绝对路径指向conf/schema/tomcat-users.xsd

2. 确认Schema文件完整性 #

• 查看Tomcat安装目录的conf/schema文件夹，必须存在tomcat-users.xsd文件且未损坏
• 若文件丢失，从同版本Tomcat安装包中复制完整的schema文件夹到当前Tomcat目录

3. 清理Eclipse缓存与配置 #

• 关闭Eclipse，删除工作区目录下.metadata/.plugins/org.eclipse.core.resources/.projects中对应Tomcat项目的缓存文件夹
• 重新打开Eclipse，移除现有Tomcat服务器后重新添加并配置
• 若为Maven/Gradle项目，右键项目选择「刷新」或「重新加载项目」

4. 检查文件编码 #

• 用Notepad++等编辑器打开tomcat-users.xml，确认编码为UTF-8（无BOM）
• 若编码错误，重新保存为UTF-8编码

快速验证方法 #

找一个同版本Tomcat的正常tomcat-users.xml文件替换当前报错文件，尝试启动Tomcat看是否恢复正常。

内容的提问来源于stack exchange，提问作者Mahdi Bel haj said