Spring Boot上传CSV文件报错：未找到表头名称'XXXXX'如何解决？

常见读取CSV表头报错的原因及修复方案 #

• 编码不匹配
  如果你的CSV表头包含中文，大部分读取工具默认采用UTF-8编码解析，而你保存CSV时可能用了GBK/GB2312编码，解码失败就会触发表头读取错误。
  如果用Python pandas读取，可显式指定编码：

import pandas as pd
df = pd.read_csv("你的文件路径.csv", encoding="gbk")

如果是网页端上传工具，可在导入设置里手动切换匹配的编码选项。

• 表头行位置错误
  部分CSV文件第一行是备注、导出说明等非表头内容，第二行才是实际表头，默认读取第一行作为表头就会报错。
  pandas读取可通过header参数指定表头行的索引（从0开始计数），比如指定第二行作为表头：

df = pd.read_csv("你的文件路径.csv", header=1)

• 分隔符不匹配
  标准CSV默认用逗号分隔，如果你保存文件时用了分号、制表符等其他分隔符，解析工具无法正确拆分表头字段就会报错。
  可显式指定分隔符，比如指定分号分隔：

df = pd.read_csv("你的文件路径.csv", sep=";")

• 表头字段非法
  如果表头存在换行符、特殊符号、前后多余空格，或者有重复的字段名，部分解析工具会直接抛出错误。你可以直接用Excel或文本编辑器打开源CSV文件，检查表头行，删除多余的空格和特殊符号，给重复字段重命名后重新上传即可。
• 文件损坏
  如果文件下载/保存过程中损坏，或者后缀被强行修改为.csv但实际不是标准CSV格式，也会触发解析错误，你可以重新导出/获取源CSV文件后再尝试。

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