Dev Solve

中文

English
日本語

中文

English
日本語

Appearance

Hibernate 配置中禁止从外部资源下载 DTD 的解决方法 ​

问题描述 ​

在配置 Hibernate 的 hibernate.cfg.xml 文件时，您可能遇到 Downloading from external resources is disabled 的错误提示。此问题通常出现在使用 Eclipse IDE 进行 Hibernate 配置的场景中，尤其在新建 Maven 项目进行 ORM 映射配置时。错误的核心在于：XML 解析器被配置为禁止从外部资源下载 DTD 文件，而 Hibernate 配置文件通常包含外部 DTD 的引用（如 hibernate-configuration-3.0.dtd）。

错误典型表现：

  • XML 文件头出现红色错误标记
  • 控制台或编辑区显示 "Downloading from external resources is disabled"
  • Hibernate 配置无法正确加载

解决方案 ​

🛠 方法一：修改 Eclipse 的 Maven 设置（推荐） ​

  1. 打开 Eclipse 设置

    • Windows/Linux：顶部菜单栏选择 Window → Preferences
    • macOS：顶部菜单栏选择 Eclipse → Settings

  2. 导航到 Maven 配置

    • 在设置窗口左侧面板中，展开 Maven 选项
    • 进入 Maven 下的子菜单

  3. 启用下载选项

    markdown
    ## ![配置示意图](https://i.sstatic.net/Qocb4.png)
(图示：Maven 配置项截图)
    • 勾选 ❗️ Download artifact javadoc 选项
    • （可选）可同时勾选 Download artifact sources 选项

  4. 应用配置

    • 点击 Apply and Close 保存设置
    • 重新打开您的 hibernate.cfg.xml 文件
    • 执行 Maven 项目更新：右键项目 → Maven → Update Project

验证配置

修改后首次打开 XML 文件时，Eclipse 会重新解析 DTD。稍等片刻后检查文件中 DTD 声明的红色错误标记是否消失：

xml
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

🔄 方法二：临时解决（验证问题根源） ​

若需确认是否是网络资源下载限制导致的问题：

  1. 在编辑器中打开 hibernate.cfg.xml
  2. 右键代码区域 → 选择 Validate
  3. 查看错误提示中是否包含资源下载被禁用的描述

🚫 不推荐的方案 ​

避免通过以下方式解决问题：

  • ❌ 修改网络代理设置强制下载 DTD
  • ❌ 在 DTD 声明中使用离线文件路径（破坏配置可移植性）
  • ❌ 禁用 XML 验证（掩盖核心问题）

原理说明 ​

此问题的根本原因在于：

  1. Hibernate 的 XML 配置文件依赖 外部 DTD 验证结构
  2. Eclipse 的默认 Maven 配置禁用了外部资源下载
  3. DTD 文件在以下两个场景需被访问：
    • IDE 的 XML 校验过程
    • 应用运行时的配置加载（依赖策略）

当启用 Download artifact javadoc 后：

  • Eclipse 会通过 Maven 机制获取所需资源
  • 自动查找本地 Maven 仓库的 DTD 相关文件
  • 无需每次访问 hibernate.org 的远程资源

常见问题解答 ​

Q：修改后问题仍存在怎么办？ ​

  1. 检查是否有多个 Eclipse 实例运行，确保修改的实例是当前使用的
  2. 清空 Eclipse 缓存：File → Restart
  3. 核对配置路径：Windows 用户应检查 Window → Preferences，Mac 用户检查 Eclipse → Settings

Q：非 Maven 项目如何处理？ ​

虽然本文基于 Maven 项目，但使用 Gradle 或普通 Java 项目的解决方案相同——重点在于启用 Eclipse 的 DTD 资源下载机制。

Q：是否影响生产环境？ ​

完全不必担心。此配置仅影响开发环境的 IDE 行为，不会改变 Hibernate 在运行时的加载逻辑。

通过调整此项设置，您既能保留 XML 配置验证功能，又能避免因网络限制导致的配置错误，确保 Hibernate 开发环境的顺畅运行。