MapStruct布尔值全映射为false的问题排查咨询

看起来你遇到了一个典型的字段映射问题——数据库里明明存了1和0对应true/false，但接口返回的DTO里全是false。结合你的代码和场景，我来拆解最可能的原因和解决办法：

1. 最可能的元凶：ORM框架没开驼峰命名映射 #

如果你的数据库字段是下划线命名（比如default_company），而实体类用的是驼峰式的defaultCompany，但你的ORM框架（比如MyBatis、Hibernate）没开启下划线转驼峰的自动映射，就会导致数据库里的default_company值根本没赋值到实体类的defaultCompany字段上。

因为Java的boolean基本类型默认值就是false，所以实体类里这个字段一直是默认的false，MapStruct自然也就把false映射到DTO里了。

解决办法： #

• 如果用MyBatis：在配置文件里加一行开启驼峰映射：

  # application.yml示例
  mybatis:
    configuration:
      map-underscore-to-camel-case: true
  

• 如果用Hibernate：要么在实体类字段上加上@Column(name = "default_company")明确指定数据库字段名，要么开启全局驼峰映射配置。

2. JDBC驱动的类型转换bug #

有些旧版本的MySQL JDBC驱动（比如5.x早期版本）会把tinyint(1)类型当成byte处理，而不是boolean。这种情况下，数据库里的1/0无法被正确转成true/false，实体类的defaultCompany就一直是默认的false。

解决办法： #

• 直接升级MySQL JDBC驱动到最新的8.x版本，新版本已经修复了这个问题，能正确把tinyint(1)转成boolean。
• 或者在JDBC连接URL里加参数tinyInt1isBit=false，强制驱动把tinyint当数值类型处理，然后实体类可以改成Integer类型接收字段，再在MapStruct里手动转换：

  // 修改实体类字段类型
  private Integer defaultCompany;
  
  // 在Mapper里添加自定义转换逻辑
  @Mapper(componentModel = "spring")
  public interface CompanyMapper {
      @Mapping(target = "defaultCompany", expression = "java(company.getDefaultCompany() != null && company.getDefaultCompany() == 1)")
      CompanyDTO toCompanyDTO(Company company);
      // 其他方法...
  }
  

3. MapStruct的映射代码没生成正确 #

虽然概率比较低，但你可以检查下MapStruct自动生成的实现类（一般在target/generated-sources/annotations目录下的CompanyMapperImpl），看看toCompanyDTO方法里有没有复制defaultCompany字段的代码：

@Override
public CompanyDTO toCompanyDTO(Company company) {
    if ( company == null ) {
        return null;
    }

    CompanyDTO companyDTO = new CompanyDTO();

    companyDTO.setId( company.getId() );
    companyDTO.setName( company.getName() );
    companyDTO.setVat( company.getVat() );
    companyDTO.setContact( company.getContact() );
    companyDTO.setDefaultCompany( company.isDefaultCompany() ); // 必须有这行！
    return companyDTO;
}

如果这行代码缺失，大概率是实体类或DTO的Getter/Setter不符合JavaBean规范——boolean类型的字段，Getter应该是isDefaultCompany()而不是getDefaultCompany()。要是你用了Lombok的@Data注解，它会自动生成正确的方法，不用手动写。

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