Spring Boot项目中如何用Liquibase从CSV加载日期字段？

嘿，我之前在Spring Boot项目里用Liquibase导入带日期字段的CSV数据时踩过不少坑，结合你的场景给你整理了实用的解决方案。首先先把你提供的建表databaseChangelog代码格式化好：

<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog 
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog" 
    xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
    <!-- 这里补了一个带日期字段的示例建表逻辑，你可以替换成自己的表结构 -->
    <changeSet id="create-user-table" author="your-name">
        <createTable tableName="user">
            <column name="id" type="BIGINT" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="VARCHAR(255)">
                <constraints nullable="false"/>
            </column>
            <column name="join_date" type="DATE">
                <constraints nullable="false"/>
            </column>
        </createTable>
    </changeSet>
</databaseChangeLog>

核心问题：CSV日期字段的导入处理 #

CSV里的日期格式经常和数据库默认的日期解析规则不匹配，导致导入失败，下面是几个靠谱的解决办法：

1. 直接在loadData标签中指定日期格式 #

这是最常用的方案，假设你的CSV文件users.csv内容如下：

id,name,join_date
1,Alice,2023-10-05
2,Bob,2023-11-20

在databaseChangelog中添加导入的changeSet，给日期列明确指定dateFormat属性：

<changeSet id="load-users-from-csv" author="your-name">
    <loadData 
        tableName="user" 
        file="classpath:db/changelog/data/users.csv"
        separator=",">
        <column name="id" type="NUMERIC"/>
        <column name="name" type="STRING"/>
        <!-- 匹配CSV中的日期格式，比如yyyy-MM-dd -->
        <column name="join_date" type="DATE" dateFormat="yyyy-MM-dd"/>
    </loadData>
</changeSet>

2. 用SQL函数处理特殊日期格式 #

如果你的CSV里是非常规日期格式（比如MM/dd/yyyy或者带时间的yyyy-MM-dd HH:mm:ss），可以用对应数据库的日期转换函数来处理。比如MySQL用STR_TO_DATE，PostgreSQL用TO_DATE：

<changeSet id="load-users-with-custom-date" author="your-name">
    <loadData tableName="user" file="classpath:db/changelog/data/users.csv">
        <column name="id" type="NUMERIC"/>
        <column name="name" type="STRING"/>
        <!-- CSV格式为MM/dd/yyyy，用MySQL函数转换 -->
        <column name="join_date" type="DATE" computed="true">
            <valueDate>STR_TO_DATE(?, '%m/%d/%Y')</valueDate>
        </column>
    </loadData>
</changeSet>

3. 全局配置日期格式（Spring Boot专属） #

如果你的项目里多个CSV都用相同的日期格式，可以在application.properties或application.yml里全局配置Liquibase的日期解析规则，不用每个changeSet都重复写：

# 全局指定DATE类型的格式
liquibase.date-format=yyyy-MM-dd
# 全局指定TIMESTAMP类型的格式（带时间）
liquibase.datetime-format=yyyy-MM-dd HH:mm:ss

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