Spring中DTOmapper报NullPointerException的原因及解决方法

这种NullPointerException提示modelMapper为null，通常是以下几个原因导致的，对应解决方法如下：

1. 手动实例化了DTOmapper（最常见） #

如果你在AccountController里通过new DTOmapper()创建实例，而不是依赖Spring注入的Bean，Spring不会为这个手动创建的对象注入ModelMapper，自然会出现null。

解决方法：
只通过Spring容器获取DTOmapper实例，推荐使用构造方法注入（Spring 4.3+无需额外加@Autowired）：

@RestController
public class AccountController {
    private final DTOmapper dtoMapper;

    // 构造方法注入
    public AccountController(DTOmapper dtoMapper) {
        this.dtoMapper = dtoMapper;
    }

    // 接口方法中直接使用注入的dtoMapper
    @GetMapping("/user")
    public UserDTO getUser() {
        User user = ...;
        return dtoMapper.convertToDto(user);
    }
}

绝对不要在代码中手动new DTOmapper()。

2. DTOmapper的构造方法不符合Spring注入要求 #

如果DTOmapper的构造方法不是public，或者存在多个构造方法但未明确指定Spring使用哪一个，Spring无法正确注入ModelMapper。

解决方法：
确保带ModelMapper参数的构造方法是public，且是类中唯一的构造方法；如果有多个构造方法，给目标构造方法添加@Autowired注解：

@Component
public class DTOmapper {
    private final ModelMapper modelMapper;

    // 确保构造方法为public，且是唯一构造方法
    public DTOmapper(ModelMapper modelMapper) {
        this.modelMapper = modelMapper;
    }

    // 若存在多个构造方法，需标记@Autowired
    // @Autowired
    // public DTOmapper(ModelMapper modelMapper) { ... }

    public UserDTO convertToDto(User user) {
        return modelMapper.map(user, UserDTO.class);
    }
}

3. DTOmapper未被Spring组件扫描到 #

虽然你给DTOmapper加了@Component注解，但如果它所在的包不在Spring的组件扫描范围内，Spring不会将其注册为Bean，此时注入的DTOmapper可能是null（不过这种情况通常会先报DTOmapper为null，但也需排查）。

解决方法：
检查启动类的组件扫描范围，确保覆盖DTOmapper所在的包。如果启动类和DTOmapper不在同一包或子包下，显式指定扫描路径：

@SpringBootApplication(scanBasePackages = {"com.yourproject.mapper", "com.yourproject.controller"})
public class YourApplication {
    @Bean
    public ModelMapper modelMapper() {
        return new ModelMapper();
    }
}

4. ModelMapper的Bean定义存在问题 #

如果启动类中ModelMapper的@Bean方法不是public，或者返回的不是有效ModelMapper实例，Spring无法提供可注入的Bean。

解决方法：
确保ModelMapper的Bean定义正确：

@Bean
public ModelMapper modelMapper() {
    // 可根据需求配置ModelMapper，比如设置匹配策略
    ModelMapper mapper = new ModelMapper();
    mapper.getConfiguration().setMatchingStrategy(MatchingStrategies.STRICT);
    return mapper;
}

注：User是record类型不会导致此NPE，ModelMapper默认支持record的字段映射，只会影响字段填充结果，不会引发空指针。

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