SignatureDoesNotMatch错误主因是Django自动添加的请求头（如Content-Type）与OSS签名计算不一致，需关闭ALIYUN_OSS_CONTENT_TYPE_AUTO_FILL、确保Endpoint协议/区域正确、使用RAM子账号并授最小权限。
为什么直接用 django-storages 配 OSS 会报 SignatureDoesNotMatch
多数人卡在这一步：装好 django-storages 和 oss2，配完 DEFAULT_FILE_STORAGE 和 ALIYUN_OSS_BUCKET_NAME 等参数，上传文件时却返回 SignatureDoesNotMatch 错误。根本原因是 OSS 的签名算法对请求头（尤其是 Content-Type、Content-Disposition）敏感，而 Django 默认在上传时自动添加了某些头字段，与签名计算不一致。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 强制关闭 Django 自动设置
Content-Type：在settings.py中添加ALIYUN_OSS_CONTENT_TYPE_AUTO_FILL = False - 确保
ALIYUN_OSS_ENDPOINT使用 HTTPS 协议且区域匹配（例如https://oss-cn-hangzhou.aliyuncs.com），不能用控制台显示的“内网地址”或带 bucket 前缀的域名 - AccessKey 必须是 RAM 子账号（非主账号 AK），且该子账号已绑定最小必要权限策略（含
oss:PutObject、oss:GetObject）
如何让 ImageField 上传到 OSS 同时保留原始文件名和中文名
Django 默认会对上传文件名做 URL 安全化处理（如把空格转成下划线、过滤中文），但 OSS 支持 UTF-8 文件名，只要客户端和服务端编码一致即可正常存储和访问。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在模型中定义
upload_to时，显式拼接原始文件名：def upload_to_oss(instance, filename): return f"uploads/{instance.id}/{filename}" - 确保 Web 服务器（Nginx / Apache）未对请求头做编码篡改；Django 本身能正确解析 UTF-8 文件名，无需额外解码
- 如果使用表单上传，前端
<input type="file">不需特殊处理，但避免 JS 手动修改File.name导致编码混乱
如何配置不同环境（开发/生产）使用不同 OSS Bucket
本地开发时不该直连生产 Bucket，但又不能每次手动改 settings.py。靠环境变量 + 条件加载最稳妥。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在
settings/base.py中统一配置基础项：ALIYUN_OSS_ACCESS_KEY_ID = os.getenv("ALIYUN_OSS_ACCESS_KEY_ID") ALIYUN_OSS_ACCESS_KEY_SECRET = os.getenv("ALIYUN_OSS_ACCESS_KEY_SECRET") ALIYUN_OSS_ENDPOINT = os.getenv("ALIYUN_OSS_ENDPOINT") - 在
settings/production.py中写：ALIYUN_OSS_BUCKET_NAME = "my-prod-bucket" DEFAULT_FILE_STORAGE = "storages.backends.aliyun.OssStorage"
- 在
settings/local.py中写：DEFAULT_FILE_STORAGE = "django.core.files.storage.FileSystemStorage" MEDIA_ROOT = os.path.join(BASE_DIR, "media")
—— 完全绕过 OSS，避免密钥泄露风险
为什么 OSS 上的图片 URL 直接访问 403，但 Django url 属性能返回正确链接
field.file.url 返回的是带签名的临时 URL（有效期默认 15 分钟），而直接拼接 https://bucket.oss-region.aliyuncs.com/path 是私有读权限下的匿名访问，自然 403。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 若需长期公开访问，把 Bucket 权限设为“公共读”，并关闭签名：
ALIYUN_OSS_AUTH_VERSION = "v1" ALIYUN_OSS_IS_BUCKET_PUBLIC = True
- 若必须私有读，又需要前端直链（比如给 Vue/React 前端用），改用 STS 临时凭证 +
oss2.SignedUrl手动生成带过期时间的 URL，不要依赖file.url - 注意：Django 的
url方法在私有模式下底层调用的是oss2.utils.make_signed_url，其签名逻辑依赖当前时间戳和请求路径，服务端时间不准会导致签名失效
SignatureDoesNotMatch 就会稳定复现。 
