MyBatis-Plus在PostgreSQL下ASSIGN_ID生成失效问题解析

问题背景

在使用MyBatis-Plus进行数据库操作时，开发者从MySQL迁移到PostgreSQL后遇到了一个典型问题：使用@TableId(type = IdType.ASSIGN_ID)注解的主键ID在插入操作时未能正确生成，导致数据库报出违反非空约束的错误。同时，自定义的MetaObjectHandler实现的自动填充功能也失效了。

问题现象

在PostgreSQL环境下，当执行插入操作时，日志显示：

Preparing: INSERT INTO notifier_new_gm_message (id, ...) VALUES (?, ...)
Parameters: null, ...

明显可以看到主键ID被设置为null，而同样的代码在MySQL环境下却能正常工作，雪花算法能正确生成ID值。

根本原因分析

经过深入排查，发现问题出在MyBatis的配置上。在配置文件中设置了：

default-scripting-language-driver: org.apache.ibatis.scripting.xmltags.XMLLanguageDriver

这一配置会覆盖MyBatis-Plus默认的MybatisXMLLanguageDriver，导致以下两个重要功能失效：

1. ID生成策略失效：IdType.ASSIGN_ID依赖MyBatis-Plus的扩展机制来实现雪花算法ID的自动生成，当使用原生XMLLanguageDriver时，这一机制被绕过。

2. 自动填充失效：同样地，MetaObjectHandler实现的字段自动填充功能也依赖于MyBatis-Plus的扩展机制。

解决方案

解决此问题的方法很简单：移除或注释掉上述配置项，让MyBatis-Plus使用其默认的MybatisXMLLanguageDriver。这样就能保证：

1. ID生成策略正常工作
2. 自动填充功能恢复正常
3. 所有MyBatis-Plus的扩展功能都能按预期工作

技术深入

MyBatis-Plus通过扩展MyBatis的核心组件来实现各种增强功能。MybatisXMLLanguageDriver是其核心扩展点之一，它负责：

1. 解析SQL语句时识别特殊注解
2. 处理ID生成策略
3. 支持自动填充功能
4. 提供其他MyBatis-Plus特有的SQL处理逻辑

当使用原生XMLLanguageDriver时，所有这些增强功能都会被绕过，导致功能失效。

最佳实践建议

1. 谨慎修改默认配置：除非有特殊需求，否则不要轻易覆盖MyBatis-Plus的默认配置。

2. 环境迁移注意事项：当从一种数据库迁移到另一种数据库时，除了SQL语法兼容性外，还需要注意：

   • ID生成策略的实现差异
   • 事务处理机制的差异
   • 数据类型映射的差异

3. 完整的配置检查：在遇到功能异常时，应该系统性地检查所有相关配置，包括：

   • MyBatis配置
   • MyBatis-Plus配置
   • 数据源配置
   • 事务管理器配置

总结

这个问题很好地展示了框架扩展机制的重要性。MyBatis-Plus通过扩展MyBatis核心组件来提供增强功能，当这些扩展被意外覆盖时，就会导致功能异常。作为开发者，理解框架底层机制对于快速定位和解决问题至关重要。在数据库迁移等重大变更时，全面的测试和配置检查是保证系统稳定性的关键。