JAXB注解不生效主因是JDK版本升级导致模块移除或命名空间变更：Java 11+需手动引入jakarta.xml.bind依赖并改用jakarta包路径，同时确保类加@XmlRootElement、集合用@XmlElementWrapper、LocalDateTime配XmlAdapter、字段有public setter、XML声明与实际编码一致。
XML转Java Bean时JAXB注解不生效？先确认JDK版本和模块依赖
Java 11+ 默认移除了 java.xml.bind 模块，直接加 @XmlRootElement 会编译通过但运行时报 ClassNotFoundException: javax.xml.bind.JAXBContext。这不是代码写错了，是环境没配好。
- Java 8：开箱即用，不用额外引包
- Java 9–10：需在
module-info.java中声明requires java.xml.bind; - Java 11 及以上：必须手动添加 Maven 依赖：
jakarta.xml.bind:jakarta.xml.bind-api+org.glassfish.jaxb:jaxb-runtime - Spring Boot 3+ 用户注意：它默认用 Jakarta EE 9+ 命名空间，注解要从
javax.xml.bind改成jakarta.xml.bind，否则解析静默失败
JAXBContext.newInstance() 报 IllegalArgumentException: Not a valid JAXB annotation
这个错通常是因为传给 newInstance() 的类没加必要注解，或用了不支持的类型（比如接口、抽象类、泛型擦除后的集合）。
- 必须确保目标类有
@XmlRootElement（或@XmlType+@XmlAccessorType配合JAXBContext构造） - 字段若为
List<String>这种泛型集合，不能只靠@XmlElement；得加@XmlElementWrapper(name = "items")包一层，否则反序列化时 list 为空 - 如果类里有
LocalDateTime，JAXB 不认——得写适配器（XmlAdapter），不能直接用@XmlJavaTypeAdapter指向一个没重写marshal/unmarshal的空类 - 避免在 getter/setter 上乱打注解：JAXB 默认按字段绑定，除非显式设
@XmlAccessorType(XmlAccessType.PROPERTY)，否则 setter 上的@XmlElement是无效的
XML属性值绑定到Java字段时总是 null？检查命名和访问控制
比如 XML 里是 <user id="123">，Java 字段叫 userId，加了 @XmlAttribute(name = "id") 还是拿不到值——大概率是字段没提供 public setter，或者名字映射没对齐。
-
@XmlAttribute必须配合 public 的 setter 方法（哪怕只是setUserId(String s) { this.userId = s; }），字段私有但没 setter 就绑定失败 - 别依赖“自动驼峰转换”：XML 属性
first-name对应 Java 字段firstName，但 JAXB 不会自动把短横线转驼峰，必须显式写@XmlAttribute(name = "first-name") - 如果字段类型是基本类型（如
int），XML 值为空字符串或缺失时会抛NumberFormatException；建议改用包装类型（Integer），并加@XmlSchemaType(name = "string")避免强转
中文字符乱码或特殊符号解析失败？别只盯 Charset
即使指定了 InputStreamReader(..., "UTF-8")，JAXB 解析仍可能报 com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException——问题常出在 XML 声明和实际编码不一致。
立即学习“Java免费学习笔记（深入）”；
- XML 文件开头必须有声明，且与真实编码一致，例如：
<?xml version="1.0" encoding="UTF-8"?>；如果文件存的是 UTF-8，但声明写成了encoding="GBK"，JAXB 会按 GBK 解码字节，必然乱码 - 用
FileInputStream直接传给Unmarshaller.unmarshal()是危险的：它不读声明，只按平台默认编码读取；务必包装成InputStreamReader(new FileInputStream(f), StandardCharsets.UTF_8)再套InputSource - 如果 XML 来自 HTTP 响应体，注意响应头
Content-Type中的 charset 是否覆盖了 XML 声明，JAXB 优先看声明，但某些老版本实现会受响应头干扰
