Spring Boot导出CSV文件时如何只选择实体类的id、amount指定列

提供两种可落地的方案，你可以根据自己的业务场景选择：

方案1：opencsv字段过滤（改动最小，快速生效） #

你当前用的opencsv原生支持忽略指定字段，只需要给不需要导出的实体字段加@CsvIgnore注解即可：

1. 修改Report实体类代码：

// 引入注解
import com.opencsv.bean.CsvIgnore;

@Entity(name="reportDetails")
@Table(name = "reports")
public class Report {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name="id")
    private long id;

    // 忽略name字段
    @CsvIgnore
    @Column(name="name")
    private String name;

    // 忽略email字段
    @CsvIgnore
    @Column(name="email")
    private String email;

    @Column(name="amount")
    private int amount;
    
    // 原有getter/setter、构造方法保持不变
}

改完后原有业务逻辑完全不需要调整，导出的CSV就只会保留id、amount两列。

方案2：JPA投影查询（性能更优，适合多导出场景） #

如果不想修改实体类注解，或者数据量较大，推荐用JPA投影，查询数据库时直接只取需要的字段，减少IO开销：

1. 新建投影接口IReport.java放在entities包下：

package com.reports.entities;

public interface IReport {
    Long getId();
    Integer getAmount();
}

2. 修改Repository层，新增自定义查询方法：

@Repository("reportsRepository")
public interface ReportsRepository extends JpaRepository<Report,Long>{
    @Query("SELECT r.id as id, r.amount as amount FROM reportDetails r")
    List<IReport> fetchIdAndAmount();
}

3. 修改Service层，新增对应调用方法：

public List<IReport> fetchIdAndAmount() {
    return reportsRepository.fetchIdAndAmount();
}

4. 修改Controller层的导出逻辑：

@GetMapping("/export-report")
public void exportCSV(HttpServletResponse response) throws Exception {
    String filename = "details.csv";

    response.setContentType("text/csv");
    response.setHeader(HttpHeaders.CONTENT_DISPOSITION, 
               "attachment; filename=\"" + filename + "\"");

    // 泛型替换为投影接口
    StatefulBeanToCsv<IReport> writer = new StatefulBeanToCsvBuilder<IReport>(response.getWriter())
        .withQuotechar(CSVWriter.NO_QUOTE_CHARACTER)
        .withSeparator(CSVWriter.DEFAULT_SEPARATOR)
        .withOrderedResults(false)
        .build();

    // 调用新的查询方法
    writer.write(reportsService.fetchIdAndAmount());
}

自定义查询报错的常见原因 #

你之前自定义查询报错，大概率是两个问题导致：

• JPQL里的实体名写错：你给实体类加了@Entity(name="reportDetails")，所以JPQL里要写from reportDetails，不能写from Report或者表名reports
• 投影字段没有加别名：查询的字段别名要和投影接口的getter方法对应，比如r.id as id对应getId()，不然JPA无法完成字段映射

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