Django生产环境批量上传时PostgreSQL报varchar(10)值过长错误如何排查

SQLite 本身对 varchar(n) 类型的长度限制不做强制校验，即使你定义了字段长度为10，存入更长的字符串也不会抛出错误，只会静默存储。而 PostgreSQL 对字段长度有严格校验，超出指定长度就会直接抛出你遇到的截断错误，这是你本地、预发布环境正常但生产报错的核心原因。

完整报错回溯如下：

Traceback (most recent call last):
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql, params)
psycopg2.errors.StringDataRightTruncation: value too long for type character varying(10)

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/home/ubuntu/env/lib/python3.6/site-packages/import_export/resources.py", line 668, in import_row
self.save_instance(instance, using_transactions, dry_run)
File "/home/ubuntu/env/lib/python3.6/site-packages/import_export/resources.py", line 446, in save_instance
instance.save()
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/base.py", line 727, in save
force_update=force_update, update_fields=update_fields)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/base.py", line 765, in save_base
force_update, using, update_fields,
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/base.py", line 868, in _save_table
results = self._do_insert(cls._base_manager, using, fields, returning_fields, raw)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/base.py", line 908, in _do_insert
using=using, raw=raw,
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/manager.py", line 85, in manager_method
return getattr(self.get_queryset(), name)(*args, **kwargs)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/query.py", line 1270, in _insert
return query.get_compiler(using=using).execute_sql(returning_fields)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/models/sql/compiler.py", line 1416, in execute_sql
cursor.execute(sql, params)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/backends/utils.py", line 66, in execute
return self._execute_with_wrappers(sql, params, many=False, executor=self._execute)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/backends/utils.py", line 75, in _execute_with_wrappers
return executor(sql, params, many, context)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql, params)
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/utils.py", line 90, in __exit__
raise dj_exc_value.with_traceback(traceback) from exc_value
File "/home/ubuntu/env/lib/python3.6/site-packages/django/db/backends/utils.py", line 84, in _execute
return self.cursor.execute(sql, params)
django.db.utils.DataError: value too long for type character varying(10)

• 第一步：定位目标字段
  找到你当前导入功能对应的Django Model，筛选出所有定义了max_length=10的CharField字段，这些是可能出问题的候选字段。
• 第二步：核对导入数据
  找到报错提示的第1行导入数据，逐一核对该行各个字段值的长度，注意排查肉眼不可见的隐形字符（比如前后空格、换行符、全角空格、特殊符号等），如果候选字段是用来存储日期的，还要检查是不是导入的日期带了时间部分导致长度超标。
• 第三步：核对字段映射关系
  检查你编写的ImportExportModelAdmin对应的Resource类的字段映射配置，确认是否存在导入文件的长字段错误映射到短字段的情况，比如把备注字段的内容导入到了状态短字段中。
• 快速定位技巧：可以在Resource类的save_instance方法中加入临时调试代码，打印每个待保存实例的所有max_length=10字段的内容和长度，运行一次导入就能直接定位到超长的字段。

根据排查结果选择对应处理方案：

• 如果是导入数据不符合要求：
  要么修改导入文件中的超长内容，要么在Resource类中添加字段清洗逻辑，比如自动截断超长内容、或者在导入前增加校验逻辑，抛出更明确的错误提示告知用户哪个字段超长。
• 如果是字段长度设置不合理：
  调整对应Model字段的max_length到合理值，生成并执行迁移文件同步到生产PostgreSQL数据库即可，调整字段长度为更大值不会影响现有数据。

建议后续将预发布环境的数据库替换为和生产一致的PostgreSQL，避免因为数据库特性差异导致的问题遗漏到生产环境。

内容的提问来源于stack exchange，提问作者Prosy A.