“解决外部 DTD 读取问题：mybatis生成器配置1.dtd文件访问属性设置错误“

最新推荐文章于 2025-09-15 11:37:14 发布

NknkCode

最新推荐文章于 2025-09-15 11:37:14 发布

阅读量938

点赞数

CC 4.0 BY-SA版权

文章标签： mybatis Mybatis

本文链接：https://blog.youkuaiyun.com/NknkCode/article/details/133733158

Mybatis 专栏收录该内容

31 篇文章 ¥59.90 ¥99.00

订阅专栏

在配置MyBatis生成器时，可能会遇到'accessExternalDTD属性设置错误'，原因是XML解析器默认不允许加载外部DTD文件。解决方法包括调整Java内置XML解析器的accessExternalDTD属性或使用MyBatis的XPathParser。本文提供了相应的源代码示例。

在使用MyBatis生成器配置文件时，有时会遇到一个常见的错误消息：“外部 DTD 无法读取外部 DTD ‘mybatis generator config 1 dtd’，因为accessExternalDTD属性设置的”。这个错误通常是由于DTD（Document Type Definition）文件的访问权限设置不正确引起的。本文将介绍如何解决这个问题，并提供相应的源代码示例。

首先，让我们理解一下这个错误的原因。DTD文件是用于验证XML文档结构的规范。在使用MyBatis生成器时，它会尝试加载与配置文件相关联的DTD文件。然而，由于某些安全性考虑，许多XML解析器默认情况下不允许加载外部DTD文件。这就是为什么会出现上述错误消息的原因。

要解决这个问题，我们需要调整XML解析器的accessExternalDTD属性设置。具体的解决方法取决于你使用的XML解析器。

以下是两种常见的XML解析器和相应的解决方法：

使用Java内置的XML解析器（例如，使用javax.xml.parsers.DocumentBuilderFactory）：

DocumentBuilderFactory factory = DocumentBuilderFactory.

了解本专栏

订阅专栏解锁全文

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

NknkCode

关注关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

订阅专栏

后端开发必备：MyBatis的代码生成器使用

架构师的AI之路，分享AI应用开发架构的学习与实践。

06-16

487

在后端开发过程中，与数据库交互是常见的任务。使用MyBatis进行数据库操作时，需要编写大量的实体类、Mapper接口和XML映射文件，这些代码具有一定的规律性且重复性较高。MyBatis代码生成器的目的就是自动化生成这些代码，减少开发者的手动编码工作量，提高开发效率和代码质量。本文的范围涵盖了MyBatis代码生成器的基本原理、使用方法、实际应用案例以及相关工具资源的推荐。本文将按照以下结构进行阐述：首先介绍MyBatis代码生成器的核心概念和联系，包括其工作原理和架构；

5.6 Mybatis代码生成器Mybatis Generator (MBG)实战详解

最新发布

weixin_42573757的博客

09-15

576

MyBatis 是一个基于 Java 的持久层框架，以其轻量级、灵活性和高效性在企业级开发中广受欢迎。它通过 XML 或注解方式将 SQL 语句与 Java 对象进行映射，简化了数据库操作流程，同时保留了对 SQL 的完全控制权。相较于传统的 JDBC 编程和 Hibernate 等 ORM 框架，MyBatis 在性能和可控性之间取得了良好的平衡。其核心组件包括config.xml全局配置文件与mapper.xml映射文件，二者分别定义了运行环境与 SQL 映射逻辑。

mybatis dtd 文件

06-27

用于myeclipse 编写mybatis 配置文件时没有网络没有提示，导入dtd 文件即可

mybatis的dtd文件

08-31

mybatis的dtd文件，使xml书写更简单，提示更明了，希望对大家有帮助

外部 DTD: 无法读取外部 DTD ‘mybatis-generator-config_1_0.dtd‘, 因为 accessExternalDTD 属性设置的限制导致不允许

qq_43212427的博客

12-13

2176

【代码】外部 DTD: 无法读取外部 DTD ‘mybatis-generator-config_1_0.dtd‘, 因为 accessExternalDTD 属性设置的限制导致不允许。

mybatis报-因为 accessExternalDTD 属性设置的限制导致不允许 http 访问

javaThinker的专栏

11-29

9198

外部 DTD: 无法读取外部 DTD 'mybatis-3-config.dtd', 因为 accessExternalDTD 属性设置的限制导致不允许 'http' 访问。 Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: ### Error building SqlSession. ...

MyBatis中的Mapper文件配置——编写mybatis mapper.xml文件

AI天才研究院

07-29

7122

MyBatis 是一款优秀的持久层框架，它可以使得使用 SQL 和 HQL 来操作数据库变得很简单， MyBatis 将原生的jdbc API隐藏在接口中，使开发人员更关注业务逻辑，从而方便地实现数据持久化操作。MyBatis 中最重要的组件之一就是 MyBatis 的 Mapper XML 配置文件。Mapper XML 配置文件用来描述 MyBatis 映射器接口及其对应的 SQL、SQL语句的参数类型、返回值类型等信息。

Mybatis知识点详解及遇到问题解决方案，动态代理，注解与反射

weixin_51261234的博客

08-22

3086

1.Mybatis：初见Mybatis： MyBatis简介环境说明： jdk 8 + MySQL 5.7.19 maven-3.6.1 IDEA 学习前需要掌握： JDBC MySQL Java 基础 Maven Junit 什么是Mybatis： MyBatis 是一款优秀的持久层框架 MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程 MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的实体类【Plain

mybatis配置dtd文件

05-10

编写ibatis（mybatis）XML文件一定需要的dtd文件

mybatis-dtd约束文件

10-22

dtd,是mybatis框架中的xml约束文件，能够规范xml文件的书写

mybatis-3-config/mapper.dtd 解决mybatis头文件报错

04-10

解决mybatis头文件报错下载好压缩包解压将文件放到本地文件夹例如 D盘的哪个文件夹 D:\mybatis\ ；然后打开eclipse ->Window->prefenrence->XML->XML Catalog->User Specifiled Entreis->Add->Location(此处是你放dtd文件的位置例如：‪D:\mybatis\mybatis-3-config.dtd)->Key(如果更改config，此处应该是：-//mybatis.org//DTD Config 3.0//EN；如果更改mapper，此处应该是：-//mybatis.org//DTD Mapper 3.0//EN) ; 执行完上面后clean项目（Project->clean）; 如果继续报错则更改出错的头文件将改为

mybatis-3-config.dtd mybatis-3-mapper.dtd

04-08

mybatis配置的重要文件包括mybatis-3-config.dtd mybatis-3-mapper.dtd

Mybatis中的DTD文件

weixin_30423977的博客

07-08

253

如Mybatis中使用DTD来验证XML Java代码 <?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEconfiguration PUBLIC"-//mybatis.org//DTDConfig3.0//EN" "http://mybatis.org/d...

JDK11单元测试-无法读取外部 DTD

keep_learn的专栏

10-31

1714

项目紧张的时候，大部分单元测试都是后期补充的，最近一个客户管理中心的项目进行时发现一个报错这里是引用外部 DTD: 无法读取外部 DTD ‘mybatis-generator-config_1_0.dtd’, 因为 accessExternalDTD 属性设置的限制导致不允许 ‘http’ 访问。参考资料： https://blog.csdn.net/dingshuo168/article/details/103317453?utm_medium=distribute.pc_relevant.no

MybatisGenerator.xml文件中dtd报错

qq_68564089的博客

07-03

1435

在写MybatisGenerator.xml文件中dtd报错，需要添加dtd文件

掌握MyBatis DTD文件：配置文件校验与IDE集成

weixin_30476025的博客

12-03

986

本文还有配套的精品资源，点击获取简介：MyBatis DTD文件是MyBatis框架中用于校验XML配置文件正确性的文档类型定义文件。它定义了配置文件的元素和属性，帮助IDE如MyEclipse在离线状态下也能提供代码提示和自动完成功能，从而提高开发效率并减少配置错误。本文介绍了DTD的基本概念、MyBatis配置文件的关键元素和属性，并强调了导入DTD文件对于确保XML...

外部 DTD: 无法读取外部 DTD 'webapi-mapper.dtd',

03-29

<think>好的，我现在需要解决用户无法读取外部DTD 'webapi-mapper.dtd' 的问题。根据用户提供的引用内容，他们提到了MyBatis的配置文件和DTD声明。首先，我应该回顾一下MyBatis中DTD文件的作用。DTD（文档类型定义）用于验证XML文件的结构是否正确，确保配置符合MyBatis的要求。用户的问题是无法读取外部DTD文件，可能的原因有几个：网络问题导致无法下载DTD，本地缓存中没有该文件，或者配置文件中的DTD声明有误。查看用户提供的引用[1]，他们的UserMapper.xml文件使用的是正确的MyBatis DTD URL：http://mybatis.org/dtd/mybatis-3-mapper.dtd。但用户现在遇到了关于'webapi-mapper.dtd'的问题，这说明他们可能在另一个配置文件中使用了不同的DTD，或者存在拼写错误。首先，我需要确认用户是否正确引用了DTD。可能他们误将DTD URL写成了'webapi-mapper.dtd'，而正确的应该是MyBatis官方的DTD。例如，正确的Mapper DTD应该是mybatis-3-mapper.dtd。因此，用户需要检查XML文件中的DOCTYPE声明是否正确。其次，如果网络连接有问题，无法访问外部DTD，可能会导致XML解析器报错。这时候可以考虑将DTD文件下载到本地，并在XML中引用本地路径。例如，修改DOCTYPE声明为指向本地的DTD文件，但需要注意路径是否正确，并且确保所有开发环境都包含该文件，这可能不太方便。另一种方法是配置XML解析器忽略DTD验证。例如，在IDE（如IntelliJ IDEA或Eclipse）中设置不验证DTD，或者在解析XML时禁用验证。但这种方法可能会影响配置文件的正确性检查，不建议长期使用。另外，检查是否使用了正确的MyBatis版本，不同版本的DTD可能有不同的URL。用户引用的mybatis-generator-maven-plugin版本是1.3.6，对应的MyBatis版本可能需要确认是否兼容。综合来看，最可能的解决方案是更正DOCTYPE声明中的DTD URL，确保其指向正确的MyBatis官方DTD。如果网络问题无法解决，则考虑使用本地DTD文件或配置解析器忽略验证。此外，用户需要检查项目配置，确保所有相关依赖正确，比如MyBatis的核心库是否正确引入，避免因版本不匹配导致的问题。</think>### 解决无法读取外部DTD 'webapi-mapper.dtd' 的方法 #### 1. **确认DTD声明是否正确** - 检查XML文件中DOCTYPE声明是否符合MyBatis官方要求。根据引用[1]，正确的MyBatis Mapper DTD应为： ```xml <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> ``` 如果声明中误写为`webapi-mapper.dtd`，需修正为上述官方URL[^1]。 #### 2. **配置本地DTD缓存（适用于网络受限环境）** - 若无法访问外部DTD（如企业内网限制），可将DTD文件下载到本地，并在XML中引用本地路径： ```xml <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "file:///path/to/local/mybatis-3-mapper.dtd"> ``` - 需确保所有开发环境均包含该文件，路径需与实际存放位置一致。 #### 3. **禁用XML验证（临时方案）** - **在IDE中禁用验证**（以IntelliJ为例）： 1. 打开设置 → Editor → File Types 2. 找到XML文件类型，添加`;!DOCTYPE`到"Ignore files and folders"列表 - **Maven构建时忽略DTD验证**：在`pom.xml`中配置Maven Surefire插件： ```xml <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <configuration> <argLine>-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl</argLine> </configuration> </plugin> ``` #### 4. **检查依赖与版本兼容性** - 确保使用的MyBatis版本与DTD声明匹配。例如： - MyBatis 3.5.x 对应 `mybatis-3-mapper.dtd` - 检查`pom.xml`中依赖是否完整： ```xml <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.6</version> </dependency> ``` #### 5. **验证配置文件完整性** - 根据引用[2]，Mapper XML文件需满足以下条件： - 文件名与Mapper接口名称一致（如`UserMapper.java`对应`UserMapper.xml`） - 存放路径与接口包路径一致（如`src/main/resources/cn/sps/lc/mapper/UserMapper.xml`） --- ### 相关问题 1. **如何验证MyBatis的XML配置文件是否正确加载？** - 可在日志配置中启用`debug`模式，查看是否输出`Parsed mapper file: [文件路径]`。 2. **MyBatis Generator如何自动生成符合DTD的XML文件？** - 引用[3]中的插件配置可结合`jdbc.properties`（引用[4]）自动生成实体类和Mapper文件，确保生成内容符合DTD规范。 3. **如何解决IDE中XML文件的DTD警告但不影响运行？** - 通过**Alt+Enter**选择`Fetch external resource`或`Disable DTD verification`临时忽略警告。