Spring CrudRepository保存内容被截断至32000字符问题咨询

这种情况我之前也碰到过，明明数据库列是支持大文本的LONGTEXT，但Spring Data JPA保存的时候却莫名截断到32000字符，大概率是映射配置或驱动参数的问题，下面给你一步步排查的思路：

1. 先检查实体类的字段映射是否正确 #

很多时候问题出在这里：JPA默认会把String类型字段映射为VARCHAR类型，而有些数据库（比如MySQL）的VARCHAR有长度上限，且如果你的实体没显式指定列类型，Hibernate可能会根据默认规则把字段设为较短的长度，甚至自动截断内容。

解决方法是给字段加上明确的注解，强制映射到LONGTEXT：

@Entity
public class YourEntity {
    @Id
    private Long id;

    // 方式一：指定columnDefinition为LONGTEXT，明确长度上限
    @Column(columnDefinition = "LONGTEXT", length = 4194304) // 4194304是LONGTEXT的最大字符数（约4MB）
    private String payload;

    // 方式二：结合@Lob注解（更通用，适配不同数据库）
    // @Lob
    // @Column(columnDefinition = "LONGTEXT")
    // private String payload;

    // getter、setter方法
}

修改后记得重启应用，或者手动同步数据库表结构（如果用hibernate.hbm2ddl.auto=update，可能需要先删除原列再重建，避免类型不兼容）。

2. 验证JDBC驱动的参数配置 #

如果实体映射没问题，那可能是JDBC驱动对数据包大小的限制导致的。以MySQL为例，默认的max_allowed_packet参数是4MB，但有时候驱动层面的默认值可能更小，导致大文本被截断。

你可以在数据源URL中显式设置这个参数，比如：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC&max_allowed_packet=67108864

这里设置的是64MB，足够覆盖你的400万字符需求（约4MB左右）。

3. 确认数据库表的实际列类型 #

虽然你说列是LONGTEXT，但最好手动验证一下，避免JPA自动更新表结构时把列类型改了。执行SQL查询：

DESCRIBE your_entity_table;

查看payload列的类型是否确实是LONGTEXT，而不是VARCHAR(32000)或者其他限制长度的类型。如果不对，手动修改列类型：

ALTER TABLE your_entity_table MODIFY COLUMN payload LONGTEXT;

4. 绕过JPA测试原生JDBC插入 #

如果上面的步骤都没解决问题，可以写一个简单的原生JDBC测试，直接插入长文本到数据库：

@Autowired
private DataSource dataSource;

public void testNativeInsert() throws SQLException {
    String longContent = new String(new char[4000000]).replace('\0', 'a'); // 生成400万字符的字符串
    try (Connection conn = dataSource.getConnection()) {
        String sql = "INSERT INTO your_entity_table (id, payload) VALUES (?, ?)";
        try (PreparedStatement stmt = conn.prepareStatement(sql)) {
            stmt.setLong(1, 1L);
            stmt.setString(2, longContent);
            stmt.executeUpdate();
        }
    }
}

如果这个测试能成功插入完整内容，说明问题出在Spring Data JPA/Hibernate的配置上；如果还是被截断，那就是数据库本身的配置或者驱动的问题，需要检查数据库的max_allowed_packet参数（在MySQL的my.cnf/my.ini中设置）。

最后总结 #

最常见的原因就是实体字段没有正确映射到LONGTEXT类型，导致JPA自动用了有限长度的VARCHAR；其次是JDBC驱动的数据包大小限制。按照上面的步骤排查，应该能解决问题。

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