将Pandas中XLSX数据导入SQL Server时遇截断与ID空值错误

一、字符串截断错误（SQLState 22001） #

改成varchar(max)还出现截断，大概率是数据本身或解析环节的问题，试试这些排查点：

• 清理XLSX里的隐藏字符：很多时候单元格里藏着换行、全角空格、控制字符，这些会让BCP解析时误判长度。用Python做个简单清理：

  import re
  def clean_field(value):
      if isinstance(value, str):
          # 去掉不可见控制字符和首尾空白
          return re.sub(r'[\x00-\x1f\x7f-\x9f]', '', value.strip())
      return value
  

• 核对字段分隔符：如果处理XLSX时转成了中间CSV，要确保分隔符（比如逗号）没在数据里出现（没转义的话会导致列错位，多列内容挤到一个字段里触发截断）。
• 查单元格实际长度：有些单元格看起来内容短，实际藏了大量空白，用len(cell_value)打印出来看看真实长度。

二、ID字段NULL错误（SQLState 23000） #

CSV导入不用手动给ID，XLSX却报错，不是格式差异，是处理逻辑的问题：

• 先确认表的ID是不是自增字段：执行这条SQL查一下：

  SELECT is_identity FROM sys.columns 
  WHERE name = 'ID' AND object_id = OBJECT_ID('My_database.dbo.My_Table')
  

  如果返回1，说明ID是自动生成的，那导入XLSX时别把ID列放进字段列表里，让数据库自己生成就行——CSV导入时你应该没传ID列，所以没问题。
• 检查XLSX的ID列：如果XLSX里有ID列但全是空，或者代码把别的列映射到了ID，就会传NULL进去。核对下Python处理时的字段映射，确保ID要么不传（自增），要么有合法整数。

三、通用排查技巧 #

• 把XLSX首行手动存成CSV，用BCP命令直接导，看看还报错不，先排除Python代码的问题。
• 打印Python处理后XLSX的每一行数据，和能正常导入的CSV行对比，看字段数量、值的格式、ID列是否存在这些差异。
• 检查日期字段：Excel的日期是浮点数存储的，如果没转成正确的datetime格式，可能被当成超长字符串处理，也会触发截断错误。

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