MyBatis-Plus自定义ID生成器配置问题解析

在使用MyBatis-Plus 3.5.x版本时，开发者可能会遇到自定义ID生成器(IdentifierGenerator)配置不生效的问题。本文将深入分析这一问题，并提供完整的解决方案。

问题现象

当开发者尝试通过以下方式配置自定义ID生成器时，发现系统仍然使用默认的DefaultIdentifierGenerator：

1. 使用@Bean注解配置GlobalConfig并设置自定义IdentifierGenerator
2. 在主键字段上配置@TableId(type = IdType.ASSIGN_ID)
3. 未在全局配置中设置相关信息

问题原因分析

经过深入研究发现，导致自定义ID生成器不生效的主要原因有以下几点：

1. 配置顺序问题：MyBatis-Plus的初始化过程中，GlobalConfig的加载时机可能早于自定义ID生成器的注入
2. SQLSessionFactoryBean覆盖：开发者自行配置SQLSessionFactoryBean可能导致MyBatis-Plus的自动配置失效
3. Bean注入方式不当：直接将IdentifierGenerator实现类注入Spring容器，但未正确关联到MyBatis-Plus的核心配置中

解决方案

推荐方案一：通过GlobalConfig配置

@Configuration
public class MybatisPlusConfig {
    
    @Bean
    public GlobalConfig globalConfiguration(IdGenService idGenService) {
        GlobalConfig conf = new GlobalConfig();
        // 使用Lambda表达式定义ID生成逻辑
        conf.setIdentifierGenerator(entity -> idGenService.getNextId());
        return conf;
    }
}

推荐方案二：实现IdentifierGenerator接口

@Component
public class CustomIdGenerator implements IdentifierGenerator {
    
    @Autowired
    private IdGenService idGenService;
    
    @Override
    public Number nextId(Object entity) {
        return idGenService.getNextId();
    }
}

重要注意事项

1. 避免覆盖关键Bean：不要自行配置SqlSessionFactoryBean，否则会破坏MyBatis-Plus的自动配置机制
2. 检查依赖版本：确保所有MyBatis-Plus相关组件的版本一致
3. 配置验证：启动应用后，可通过调试查看IdentifierGenerator的实际类型确认配置是否生效

最佳实践建议

1. 对于简单场景，推荐使用方案二的@Component方式，更为简洁
2. 对于需要复杂逻辑的场景，可使用方案一，通过GlobalConfig进行更灵活的配置
3. 在生产环境中，建议为ID生成器添加适当的异常处理和日志记录
4. 考虑ID生成性能，特别是在高并发场景下

通过以上分析和解决方案，开发者应该能够正确配置MyBatis-Plus的自定义ID生成器，满足各种业务场景的需求。