Django使用Tastypie上传UTF-8命名文件时触发UnicodeEncodeError的修复方法

• 自定义get_path上传路径函数主动返回了UTF-8编码的字节串，而非Django存储层要求的Unicode字符串
• Django内置的FileSystemStorage在拼接上传路径时，默认按ASCII规则做编码校验，遇到超出ASCII范围的非拉丁字符（如本次报错涉及的波斯语文件名فیلتر.png）、或是字节类型的路径输入，就会触发UnicodeEncodeError
• 该问题和Tastypie上传链路无直接关联，属于路径函数返回值类型错误引发的编码不兼容问题

1. 修正上传路径函数的返回逻辑 #

移除get_path中多余的.encode('utf-8')编码操作，保证函数返回纯Unicode字符串；同时修正原代码中用空格做路径拼接的错误（空格会导致路径被错误分段、丢失文件名语义），正确的函数写法如下：

# -*- coding: utf-8 -*-
def get_path(instance, filename):
    # 直接返回Unicode格式的路径拼接结果，使用/做路径分隔符
    return u'/'.join((u'document', filename)).strip()

2. 增加文件名编码兜底校验 #

部分客户端上传文件时，传递的文件名会以字节串形式传入路径函数，需要在函数内增加一层解码逻辑，避免直接触发编码报错：

def get_path(instance, filename):
    # 兜底：如果传入的文件名是字节类型，强制按UTF-8解码为Unicode
    if isinstance(filename, bytes):
        filename = filename.decode('utf-8')
    return u'/'.join((u'document', filename)).strip()

3. Tastypie层适配调整 #

旧版Tastypie在处理文件上传时，会对非ASCII文件名做默认的ASCII转码处理，需要在对应的资源类中增加钩子覆盖默认逻辑，保证文件名以UTF-8 Unicode形式传入模型层：

• 在Tastypie资源类中重写文件上传预处理逻辑，强制将上传的文件名字段解码为UTF-8字符串
• 确认Python运行进程的文件系统编码为UTF-8，避免进程在拼接本地存储路径时默认使用ASCII编码

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