必须用 FileField。ImageField 是其子类，会强制用 Pillow 检查图像头，上传 XML 时抛出 ValidationError；FileField 仅校验文件有效性，需手动在 clean() 中验证后缀和 XML 格式。
上传XML文件该用 FileField 还是 ImageField？
必须用 FileField。ImageField 是 FileField 的子类，但会强制调用 PIL/Pillow 检查文件头是否为图像格式——上传 .xml 文件时会直接抛出 ValidationError: Upload a valid image 错误，哪怕文件内容完全合法。
FileField 上传 XML 的最小可行配置
只需在模型中声明 FileField，并确保表单允许 multipart/form-data 编码。Django 不校验 XML 内容，只校验是否为有效上传文件（非空、大小未超限等）。
-
upload_to参数建议设为字符串（如'uploads/xml/'），避免使用函数导致迁移问题 - 若需限制仅接受 XML，必须手动加验证：在模型的
clean()方法或表单的clean_file()中检查file.name.endswith('.xml')和/或file.content_type == 'application/xml' - 注意
request.FILES中的文件对象是InMemoryUploadedFile或TemporaryUploadedFile，读取内容需用file.read()，且读取后指针已到末尾，重复读需file.seek(0)
class Document(models.Model):
xml_file = models.FileField(upload_to='uploads/xml/')
<pre class='brush:php;toolbar:false;'>def clean(self):
super().clean()
if self.xml_file:
if not self.xml_file.name.lower().endswith('.xml'):
raise ValidationError('仅支持 .xml 文件')
# 可选：解析验证格式
try:
from xml.etree import ElementTree
ElementTree.parse(self.xml_file)
except Exception as e:
raise ValidationError(f'XML 格式错误: {e}')ImageField 为什么不能传 XML？
ImageField 在保存前会调用 django.core.files.images.get_image_dimensions()，该函数内部使用 Pillow 打开文件并读取头信息。XML 文件没有 JPEG/PNG 等图像签名，Pillow 抛出 UnidentifiedImageError，Django 捕获后转为用户友好的验证错误。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 即使把 XML 文件重命名为
test.jpg，只要内容不是图像二进制，仍会失败 - ImageField 的数据库字段仍是
varchar，和 FileField 一样存路径，不存二进制数据 - 不要试图绕过校验——比如重写
save()跳过尺寸检查，会导致 admin 和序列化行为不一致
前端和视图层要注意什么？
模板中用 <input type="file" name="xml_file"> 即可，但需确保 <form></form> 有 enctype="multipart/form-data"；视图里用普通 ModelForm 处理，无需额外解包。
- 如果用 AJAX 上传，
FormData对象添加文件时，key 必须和表单字段名一致（如formData.append('xml_file', fileInput.files[0])） - 上传大 XML 文件时，注意 Nginx/Apache 的
client_max_body_size和 Django 的DATA_UPLOAD_MAX_MEMORY_SIZE配置 - 生产环境别把 XML 存数据库 Blob 字段——FileField 的文件系统存储更可靠，也方便后续用
curl或脚本直接读取原始内容
真正容易被忽略的是 XML 内容校验时机：模型 clean() 在表单 is_valid() 之后、save() 之前执行，但如果文件太大，可能已在 request.FILES 阶段被中间件拦截。先做基础后缀/类型检查，再考虑解析，否则异常会跳过所有 Django 表单错误收集机制。
