求助：Apache Solr 9.0.0 DataImport Handler配置及多数据库导入、版本迁移问题

一、核心加载失败的核心原因与基础修复 #

Solr 9 对DIH的配置结构做了明确调整，旧版本的松散配置方式（比如随意放置<requestHandler>、依赖包路径错误）会直接导致核心加载失败，先做以下基础配置：

• 依赖包校验：
  • Solr 9默认已在server/solr-webapp/webapp/WEB-INF/lib内置solr-dataimporthandler-9.x.x.jar和solr-dataimporthandler-extras-9.x.x.jar，无需额外复制；但自定义核心需确保在solrconfig.xml中通过<lib>标签正确引入（路径可相对核心目录或Solr全局lib目录）。
  • 数据库驱动包：将MySQL的mysql-connector-java-8.x.x.jar、SQL Server的mssql-jdbc-12.x.x.jar放到核心的lib子目录（无则新建），或Solr全局server/lib/ext目录。
• 规范配置DIH Handler：
  必须将DIH的请求处理器放在solrconfig.xml的<requestHandlers>节点内，避免加载报错：

  <requestHandlers>
    <!-- 其他默认handler -->
    <requestHandler name="/dataimport" class="org.apache.solr.handler.dataimport.DataImportHandler">
      <lst name="defaults">
        <str name="config">data-config.xml</str>
      </lst>
    </requestHandler>
  </requestHandlers>
  

  注意：data-config.xml需放在核心的conf目录下，与solrconfig.xml同级。

二、Data Config文件配置（数据源+导入规则） #

在核心conf目录创建data-config.xml，以下是两种数据库的配置示例：

1. MySQL数据源配置 #

<dataConfig>
  <dataSource type="JdbcDataSource"
              driver="com.mysql.cj.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC"
              user="db_user"
              password="db_pass"/>
  <document>
    <entity name="target_table" query="SELECT id, title, content, update_time FROM target_table">
      <field column="id" name="id"/>
      <field column="title" name="title"/>
      <field column="content" name="content"/>
      <!-- 增量导入配置（可选） -->
      <field column="update_time" name="update_time"/>
      <deltaQuery>SELECT id FROM target_table WHERE update_time > '${dataimporter.last_index_time}'</deltaQuery>
      <deltaImportQuery>SELECT id, title, content, update_time FROM target_table WHERE id = '${dataimporter.delta.id}'</deltaImportQuery>
    </entity>
  </document>
</dataConfig>

• 强制要求：MySQL 8+必须使用com.mysql.cj.jdbc.Driver驱动类，URL需指定时区参数。

2. SQL Server数据源配置 #

<dataConfig>
  <dataSource type="JdbcDataSource"
              driver="com.microsoft.sqlserver.jdbc.SQLServerDriver"
              url="jdbc:sqlserver://localhost:1433;databaseName=your_db;encrypt=false"
              user="db_user"
              password="db_pass"/>
  <document>
    <entity name="target_table" query="SELECT id, title, content, update_time FROM target_table">
      <field column="id" name="id"/>
      <field column="title" name="title"/>
      <field column="content" name="content"/>
      <!-- 增量导入配置（可选） -->
      <field column="update_time" name="update_time"/>
      <deltaQuery>SELECT id FROM target_table WHERE update_time > '${dataimporter.last_index_time}'</deltaQuery>
      <deltaImportQuery>SELECT id, title, content, update_time FROM target_table WHERE id = '${dataimporter.delta.id}'</deltaQuery>
    </entity>
  </document>
</dataConfig>

• 注意：URL需明确指定databaseName，无需加密时添加encrypt=false参数。

三、验证与数据导入 #

• 重启Solr服务，进入Admin UI的Core Admin查看核心状态，若仍加载失败，直接查看server/logs/solr.log定位错误（常见问题：驱动包缺失、XML语法错误、DIH依赖未正确引入）。
• 核心激活后，进入Dataimport页面，选择对应数据源，点击Execute执行全量导入；如需增量导入，确保entity中配置了deltaQuery和deltaImportQuery。

四、Solr 8→9迁移额外注意事项 #

• 不要直接复用Solr 8的核心配置，建议基于Solr 9默认核心配置（server/solr/configsets/_default/conf）修改，避免过时语法导致的加载问题。
• 确保数据库驱动适配Java 11+（Solr 9默认依赖Java 11），比如MySQL驱动需8.0+，SQL Server驱动需10.2+。
• 增量导入的时间字段需注意时区一致性，避免漏导或重复导入数据。

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