1. 问题背景与现象分析最近在使用JeecgBoot框架开发新功能时遇到了一个典型问题在新增接口中设置的默认值无法正常生效。具体表现为前端调用新增接口时某些字段虽然在后端代码中设置了默认值但实际保存到数据库时却变成了null值。这个问题在社区中经常被提及特别是在使用代码生成器快速开发时更容易遇到。根据我的排查经验这种情况通常发生在以下几种场景使用TableField注解设置默认值但未生效通过MyBatis-Plus的自动填充功能配置默认值失败前端传参覆盖了后端设置的默认值实体类继承关系导致默认值被忽略2. 默认值失效的常见原因排查2.1 注解配置问题JeecgBoot基于MyBatis-Plus常用的默认值设置方式是通过TableField注解TableField(fill FieldFill.INSERT, value 默认值) private String status;常见配置错误包括忘记添加fill属性导致自动填充不生效value值格式不正确特别是日期类型需要特殊处理注解位置错误应该放在字段声明上方而非getter方法2.2 前端传参覆盖问题即使后端设置了默认值如果前端传入了null或空值也可能会导致默认值失效。这通常需要检查前端表单是否包含了该字段的输入项是否使用了JSON序列化工具如FastJSON的特殊配置接口文档是否明确标注了字段的非必传属性2.3 自动填充配置问题MyBatis-Plus的MetaObjectHandler是实现默认值的重要机制。常见问题包括未正确实现insertFill和updateFill方法填充处理器未被Spring容器管理字段类型与填充值类型不匹配3. 解决方案与最佳实践3.1 注解方式的正确使用对于简单的静态默认值推荐以下配置方式// 字符串类型默认值 TableField(value status, fill FieldFill.INSERT) private String status active; // 数字类型默认值 TableField(value sort_order, fill FieldFill.INSERT) private Integer sortOrder 0;重要提示对于日期类型默认值建议在MetaObjectHandler中处理而不是通过注解设置。3.2 自动填充处理器配置在JeecgBoot中正确配置自动填充创建处理器类Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, status, String.class, draft); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }确保实体类字段配置正确TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime;3.3 前端交互处理方案为了避免前端传参覆盖默认值可以采用以下策略在DTO中设置默认值public class UserAddDTO { private String status active; // getter/setter }在Controller层进行参数校验和默认值处理PostMapping(/add) public Result? add(RequestBody UserAddDTO dto) { if(dto.getStatus() null) { dto.setStatus(active); } return userService.save(dto); }4. 高级场景与疑难问题解决4.1 继承关系中的默认值问题当实体类存在继承关系时父类的默认值可能会失效。解决方案在子类中重新声明字段并设置默认值使用AttributeOverride重写字段定义在MetaObjectHandler中显式处理继承字段4.2 动态默认值的实现对于需要根据业务逻辑动态生成的默认值Component public class DynamicMetaObjectHandler implements MetaObjectHandler { Autowired private SequenceService sequenceService; Override public void insertFill(MetaObject metaObject) { // 生成订单编号 String orderNo ORD sequenceService.nextVal(order_seq); this.strictInsertFill(metaObject, orderNo, String.class, orderNo); } }4.3 多租户场景下的默认值在SAAS系统中通常需要设置租户ID默认值Component public class TenantMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { String tenantId UserContext.getCurrentTenantId(); this.strictInsertFill(metaObject, tenantId, String.class, tenantId); } }5. 常见问题排查指南5.1 默认值不生效检查清单检查注解配置是否正确TableField是否包含fill属性字段名称是否与数据库列名一致检查自动填充处理器是否添加了Component注解是否实现了正确的方法检查实体类定义字段是否有setter方法是否被final修饰检查数据库设计字段是否允许为null是否有默认值约束冲突5.2 日志调试技巧开启MyBatis-Plus的SQL日志观察INSERT语句mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl典型日志分析如果字段未出现在INSERT语句中 → 检查fill配置如果字段值为null → 检查前端传参和默认值设置5.3 与代码生成器的集成使用JeecgBoot代码生成器时注意以下配置在生成配置中指定默认值// 在代码生成器的Entity配置中 field.setColumnName(status); field.setDefaultValue(active); // 注意字符串需要引号生成后检查实体类注解TableField(value status, fill FieldFill.INSERT) private String status active;6. 性能优化建议避免在MetaObjectHandler中执行耗时操作对于大量默认值考虑使用数据库层面的DEFAULT约束将静态默认值直接定义在实体类中减少处理器负担使用缓存优化动态默认值的生成7. 替代方案比较除了MyBatis-Plus的自动填充还有其他设置默认值的方式数据库DEFAULT约束优点不依赖应用层确保数据一致性缺点无法实现动态值维护成本高XML映射文件中设置优点配置集中管理缺点不够灵活类型处理复杂AOP拦截方式优点非侵入式可统一处理缺点增加系统复杂度调试困难综合比较对于JeecgBoot项目MyBatis-Plus的自动填充机制仍然是最佳选择。