使用Hibernate与HibernateC3P0部署时遇SPATIAL_MSG_LOGGER字段缺失错误

本地使用Hibernate+Hibernate C3P0操作数据库正常，但部署后出现如下错误：

java.lang.NoSuchFieldError: SPATIAL_MSG_LOGGER
    2023-07-24T10:14:59.232-07:00   at org.hibernate.spatial.dialect.mysql.MySQLDialectContributor.contributeJdbcTypes(MySQLDialectContributor.java:28)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.spatial.contributor.SpatialTypeContributor.contribute(SpatialTypeContributor.java:22)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.boot.model.process.spi.MetadataBuildingProcess.handleTypes(MetadataBuildingProcess.java:390)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.boot.model.process.spi.MetadataBuildingProcess.complete(MetadataBuildingProcess.java:143)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.boot.model.process.spi.MetadataBuildingProcess.build(MetadataBuildingProcess.java:97)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.boot.internal.MetadataBuilderImpl.build(MetadataBuilderImpl.java:402)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.boot.internal.MetadataBuilderImpl.build(MetadataBuilderImpl.java:90)
    2023-07-24T10:14:59.232-07:00   at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:735)

未使用Hibernate空间功能，本地无此问题，无法通过搜索引擎找到该字段相关信息，不知如何排查。

• 检查依赖版本冲突：该错误多由Hibernate核心包与Hibernate Spatial包版本不匹配导致，即使未主动引入Spatial依赖，也可能被其他依赖间接带入不同版本的Spatial包。
  • 用依赖分析工具（如Maven的dependency:tree或Gradle的dependencies命令）查看是否有hibernate-spatial相关依赖被间接引入。
  • 若发现冲突，排除不兼容的Spatial版本，或统一Hibernate核心与Spatial的版本（确保两者版本完全一致）。
• 移除不必要的Spatial依赖：确认不需要空间功能时，直接在依赖管理中排除所有hibernate-spatial相关依赖。例如Maven中可通过<exclusions>标签实现：

  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>你的Hibernate版本</version>
      <exclusions>
          <exclusion>
              <groupId>org.hibernate</groupId>
              <artifactId>hibernate-spatial</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 清理部署环境类路径：本地与部署环境类路径可能存在差异，部署环境中可能混入旧版本或不兼容的Hibernate相关jar包。
  • 清理部署环境的lib目录，重新打包部署，确保仅包含项目依赖中指定的、版本一致的jar包。
• 显式指定数据库方言：避免Hibernate自动检测方言时触发Spatial相关逻辑，在Hibernate配置中显式设置非空间方言，例如MySQL使用org.hibernate.dialect.MySQL8Dialect（根据实际MySQL版本调整），而非Spatial版本的方言。

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