【EasyExcel】字段赋值错乱问题

背景:@ExcelProperty(value = "立木序号") private String number;没有导入成功,但是数据赋值到 @ApiModelProperty(value = "检尺类型") private String gaugeType;字段上了

问题: EasyExcel 导入时数据赋值错位:标注 "立木序号" 的number字段没拿到值,而本该赋给 "检尺类型" 的gaugeType字段却接收了 "立木序号" 的数据,核心原因是列名匹配混乱或列索引错位(其他字段正常说明全局导入逻辑无问题)

思考:

原因 1:列名重复 / 注解 value 写错(最常见)

这种错位本质是 EasyExcel 在匹配列名时 "找错了对象",常见场景:

  • Excel 中同时存在 "立木序号" 和 "检尺类型" 列,但gaugeType字段的@ExcelProperty注解value误写成了 "立木序号"(和number字段注解重复);

  • Excel 中列名有相似性(比如 "检尺类型" 列名被误写为 "立木序号"),导致 EasyExcel 把同一列数据匹配到了两个字段中,最终后匹配的字段覆盖 / 抢占了数据。

查看:核对两个字段的@ExcelProperty注解,确保value和 Excel 列名一一对应

原因 2:列索引错位(列名无错但顺序匹配错)

若 Excel 中列的顺序和实体类字段的 "默认匹配顺序" 不一致,且未指定index,EasyExcel 会按 "字段定义顺序" 匹配 "Excel 列顺序",导致错位:比如:

  • Excel 列顺序:立木序号(第 1 列)、检尺类型(第 2 列);

  • 实体类字段定义顺序:先gaugeType、后number;EasyExcel 会把第 1 列(立木序号)的数据赋给第一个字段gaugeType,第 2 列(检尺类型)赋给第二个字段number(若第 2 列无值则number为 null)。

解决:给每个字段指定index,但是我不想额外增加index固定死

核心解决方案:排除无需导入的字段

之所以出现数据错位赋值,是因为gaugeType字段虽然没写@ExcelProperty,但 EasyExcel 在 "按顺序匹配列" 时,仍会把列数据赋给未排除的字段;只需给gaugeType添加@ExcelIgnore注解,明确排除该字段的导入映射,就能让数据正确赋给number字段。

java 复制代码
import com.alibaba.excel.annotation.ExcelIgnore;
import com.alibaba.excel.annotation.ExcelProperty;
import io.swagger.annotations.ApiModelProperty;

public class YourEntity {
    // 立木序号:需要导入
    @ApiModelProperty(value = "立木序号")
    @ExcelProperty(value = "立木序号") 
    private String number;

    // 检尺类型:不需要导入,添加@ExcelIgnore排除映射(核心修改点)
    @ApiModelProperty(value = "检尺类型")
    @ExcelIgnore // 关键:告诉EasyExcel忽略该字段的导入/导出
    private String gaugeType;

    // 必须保留number字段的setter(之前确认过的核心要求)
    public void setNumber(String number) {
        this.number = number;
    }

    // gaugeType的setter可保留(不影响,因为已被@ExcelIgnore排除)
    public void setGaugeType(String gaugeType) {
        this.gaugeType = gaugeType;
    }

    // getter方法(方便调试查看值)
    public String getNumber() {
        return number;
    }

    public String getGaugeType() {
        return gaugeType;
    }
}

最终:导入正常赋值

相关推荐
布莱克6057 小时前
Swift 类详解:从定义、继承到内存管理的完整指南
服务器·开发语言·ios·ssh·swift·类
是main不是漫7 小时前
【快慢指针 | LeetCode202 快乐数】鸽巢原理佐证环特性,快慢指针巧解快乐数
c语言·开发语言·c++·算法
果果软件8 小时前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
布莱克6059 小时前
Swift 方法详解:实例方法、类型方法与 mutating 机制
服务器·开发语言·ios·ssh·swift·方法
Risehuxyc11 小时前
PHP能不能在参数里放匿名函数
开发语言·php
码云社区11 小时前
Java家政服务系统源码:人员技能、服务范围与多商家业务落地
java·开发语言·家政服务·家政小程序·家政系统
FRing0312 小时前
vue3干货总结3(defineOptions(Vue3.3)、defineModel(Vue3.4)、Pinia)
开发语言·前端·vue.js·vue3
摇滚侠12 小时前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger12 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
whitelbwwww13 小时前
CUDA C++实战--中级
开发语言·前端·c++