SpringBoot中JAXB通过XML字段关联数据库实体类问题

问题根源 #

JAXB默认会自行实例化XmlAdapter类，这些实例不属于Spring容器管理范畴，因此无法通过@Autowired注入Spring Bean（比如你的CountryService），导致注入的Service对象为null。

可行解决方案 #

方案1：让Spring管理XmlAdapter，手动绑定到Unmarshaller/Marshaller

1. 将CountryISO2Adapter声明为Spring组件，通过构造方法注入依赖：

@Component
public class CountryISO2Adapter extends XmlAdapter<String, Country> {

    private final CountryService countryService;

    // Spring 4.3+支持无@Autowired的构造方法注入
    public CountryISO2Adapter(CountryService countryService) {
        this.countryService = countryService;
    }

    @Override
    public Country unmarshal(String alpha2ISO) throws Exception {
        return countryService.findByAlpha2(alpha2ISO);
    }

    @Override
    public String marshal(Country country) throws Exception {
        return country != null ? country.getAlpha2ISO() : null;
    }
}

2. 在XML解析逻辑中，注入Spring管理的Adapter实例，并绑定到JAXB的Unmarshaller：

@Service
public class XmlParsingService {

    private final CountryISO2Adapter countryISO2Adapter;
    private final JAXBContext jaxbContext;

    public XmlParsingService(CountryISO2Adapter countryISO2Adapter) throws JAXBException {
        this.countryISO2Adapter = countryISO2Adapter;
        this.jaxbContext = JAXBContext.newInstance(Profile.class);
    }

    public Profile parseXml(String xmlContent) throws JAXBException {
        Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
        // 绑定Spring管理的Adapter到Unmarshaller
        unmarshaller.setAdapter(countryISO2Adapter);
        return (Profile) unmarshaller.unmarshal(new StringReader(xmlContent));
    }
}

方案2：通过Spring的JAXBContextFactoryBean自动注册Adapter

如果希望全局配置JAXBContext，避免每次手动绑定Adapter，可以用Spring提供的JAXBContextFactoryBean：

@Configuration
public class JaxbConfig {

    @Autowired
    private CountryISO2Adapter countryISO2Adapter;

    @Bean
    public JAXBContext jaxbContext() throws JAXBException {
        JAXBContextFactoryBean factoryBean = new JAXBContextFactoryBean();
        // 指定需要绑定的实体类
        factoryBean.setClassesToBeBound(Profile.class);
        // 注册Adapter到Marshaller和Unmarshaller
        Map<String, Object> jaxbProps = new HashMap<>();
        jaxbProps.put(JAXBContextProperties.MARSHALLER_ADAPTERS, countryISO2Adapter);
        jaxbProps.put(JAXBContextProperties.UNMARSHALLER_ADAPTERS, countryISO2Adapter);
        factoryBean.setJaxbContextProperties(jaxbProps);
        
        return factoryBean.createJAXBContext();
    }
}

之后在解析服务中直接注入JAXBContext即可使用，无需手动设置Adapter：

@Service
public class XmlParsingService {

    private final JAXBContext jaxbContext;

    public XmlParsingService(JAXBContext jaxbContext) {
        this.jaxbContext = jaxbContext;
    }

    public Profile parseXml(String xmlContent) throws JAXBException {
        Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
        return (Profile) unmarshaller.unmarshal(new StringReader(xmlContent));
    }
}

方案3：适配Spring MVC的XML消息转换器

如果是在Spring MVC接口中直接接收XML格式的请求（比如用@RequestBody），可以配置自定义的XML消息转换器，将Spring管理的Adapter注册进去：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Autowired
    private CountryISO2Adapter countryISO2Adapter;

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        Jaxb2RootElementHttpMessageConverter jaxbConverter = new Jaxb2RootElementHttpMessageConverter();
        // 注册Adapter到转换器的JAXB上下文
        jaxbConverter.setJaxbContextProperties(Map.of(
            JAXBContextProperties.UNMARSHALLER_ADAPTERS, countryISO2Adapter,
            JAXBContextProperties.MARSHALLER_ADAPTERS, countryISO2Adapter
        ));
        converters.add(jaxbConverter);
    }
}

注意事项 #

• 不要使用静态字段存储Service实例，这种方式会引发线程安全问题，不符合Spring的依赖注入规范。
• 优先使用构造方法注入，而非字段注入，能保证依赖的不可变性和初始化完整性。

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