EasyExcel 导入字段为 null：链式 Setter 的排查与修复

现象与适用上下文

使用 EasyExcel.read() 配合 AnalysisEventListener 导入 Excel 时，监听器能够进入行回调，但目标对象的字段仍为 null。

原有问题记录描述：能够识别数据行，在导入 VO 上显式添加 @Accessors(chain = false) 后，字段可正常读取。该记录未提供 EasyExcel、Lombok、JDK 版本、VO 源码与复现文件，因此只能确认记录中的修复结果，不能把所有导入空值都归因于链式访问器。

本文讨论使用 Java 模型对象接收 Excel 行数据，且对象访问器由 Lombok 生成的场景。能够进入回调只说明读取流程在运行，表头不匹配、空单元格等问题仍需检查。

从单元格读取到对象赋值

排查时需要分别确认三个环节：

Excel 数据行是否进入监听器。
表头或列索引是否正确匹配目标字段。
转换后的值是否成功写入对象属性。

EasyExcel v2.2.6 的模型构建代码使用 BeanMap.create(resultModel).putAll(map)；v4.0.3 仍通过 BeanMapUtils 和 BeanMap.put 写入模型属性。这个写入环节与 Setter 是否能被识别有关，不能只检查单元格有没有内容。EasyExcel v2.2.6 源码、EasyExcel v4.0.3 源码。

链式 Setter 为什么可能影响赋值

Lombok 的 @Accessors(chain = true) 会让 Setter 返回当前对象，以支持连续调用：

public ImportRow setName(String name) {
    this.name = name;
    return this;
}

标准 Setter 则返回 void：

public void setName(String name) {
    this.name = name;
}

在依赖默认 JavaBeans 内省的属性写入路径中，普通 Setter 的识别条件包括 setXxx 命名、一个参数和 void 返回值。链式 Setter 的返回类型不同，可能导致对应属性没有被识别为可写属性。这与“行回调正常、对象属性没有写入”的现象一致。Lombok Accessors 文档、CGLIB ReflectUtils 源码、OpenJDK 8 Introspector 源码。

这一机制解释了修复方向，但并非对原案例运行环境的复现。实际行为仍需结合项目所用版本与生成后的方法签名确认。

修复：让导入模型保持标准访问器

记录中的修复方式是在导入 VO 上显式关闭链式 Setter：

@Accessors(chain = false)

如果项目还启用了 fluent = true，仅设置 chain = false 不会恢复 getXxx/setXxx 命名。导入模型可以同时明确关闭这两个选项：

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;
import lombok.experimental.Accessors;

@Data
@Accessors(chain = false, fluent = false)
public class ImportRow {

    /**
     * Excel“名称”列对应的导入值。
     */
    @ExcelProperty("名称")
    private String name;
}

需要在真正声明导入字段的类上检查访问器。子类上的注解不会改写父类已经生成的方法；若字段来自父类，应检查父类 Setter，而不是仅在子类重复添加注解。

不要仅凭“字段为 null”就修改项目所有模型。先定位参与此次导入的对象及访问器，确认注解或 lombok.config 是否启用了 chain、fluent 等设置。