今天一个同事需要在项目中使用Hibernate，于是就推荐了他去阅读Hibernate的官方文档。因为这个文档不但有中文，而且还包含了一个比较详细的Tutorial。
可是当一切都配置以后，使用JUnit测试时，出现了问题：
org.hibernate.HibernateException: Could not parse configuration: /hibernate.cfg.xml at org.hibernate.cfg.Configuration.doConfigure(Configuration.java:1542) at org.hibernate.cfg.AnnotationConfiguration.doConfigure(AnnotationConfiguration.java:1035) ... Caused by: org.dom4j.DocumentException: Connection timed out: connect Nested exception: Connection timed out: connect at org.dom4j.io.SAXReader.read(SAXReader.java:484) at org.hibernate.cfg.Configuration.doConfigure(Configuration.java:1532) ... 32 more
很是奇怪，因为hibernage.cfg.xml配置文件是从Tutorial中直接copy过来的，只是改了数据库的驱动、方言和连接。也Google了一些情况出来，很多是由于DTD的版本和配置文件的版本不对导致的。不过在我们这里不存在这个情况。不过可以判定是由于DTD引起的问题，忽然想起来前一段时间服务器上一个程序由于不能连接网络，而导致Springframework不能加载的问题，就判断也可能是因为网络的问题，不能下载“http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd”（尽管我们已经把DTD下载到了本地）。
这时候还好有一段以前可以运行的程序，拿来一看恍然大悟，还果真是DTD的问题。那个配置文件里引用的是：“http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd”，不是一个地址。替换后，问题就解决了。
官方文档也害人呀！
总结：
问题现象：加载Hibernate时出现异常，可以看到异常信息：
org.hibernate.HibernateException: Could not parse configuration: /hibernate.cfg.xml
Caused by: org.dom4j.DocumentException: Connection timed out: connect Nested exception: Connection timed out: connect
原因：hibernate.cfg.xml中引用了错误的DTD文件路径“http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd”。
解决方法：替换为正确的DTD路径：“http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd”。
