直接用Pillow处理Django上传图片易出错，因未对齐Django文件系统抽象，应全程使用default_storage和ContentFile；django-imagekit通过ImageSpecField实现懒加载水印与缩略图；需用exif_transpose校正EXIF方向，自定义Processor可精细控制文字透明度。
为什么直接用Pillow处理Django上传图片容易出错
Django本身不内置图片处理能力，硬编码调用Pillow做水印或缩略图，常在save()方法里重复打开文件、手动构造路径、忽略default_storage配置，导致本地能跑、上线就报FileNotFoundError或PermissionError。关键问题不在代码逻辑，而在没和Django的文件系统抽象对齐。
正确做法是：所有读写必须走default_storage，水印/缩略图生成后也得用ContentFile写回存储，而不是open()硬写磁盘路径。
- 别在
models.py里直接from PIL import Image后调Image.open('/media/...')——路径不可靠，且绕过storage后端 - 水印文字建议用绝对像素大小（如
font_size=24），避免在不同分辨率缩略图上失真 - 缩略图尺寸建议用
thumbnail()而非resize()，前者保持比例裁剪，后者会拉伸变形
如何用django-imagekit自动绑定水印与缩略图字段
django-imagekit不是“替代Pillow”，而是把Pillow操作封装成Django字段级行为，省去手动触发时机判断。它通过ImageSpecField声明式定义输出图，真正生成发生在第一次访问.url属性时（懒加载），且全程走default_storage。
安装后，在models.py中这样写：
立即学习“Python免费学习笔记（深入）”；
from imagekit.models import ImageSpecField
from imagekit.processors import ResizeToFill, Watermark
<p>class Photo(models.Model):
original = models.ImageField(upload_to='photos/')
thumbnail = ImageSpecField(
source='original',
processors=[ResizeToFill(300, 200)],
format='JPEG',
options={'quality': 85}
)
watermarked = ImageSpecField(
source='original',
processors=[Watermark(
text='©MySite',
font_size=24,
opacity=0.6,
position='bottom-right'
)],
format='PNG'
)注意：Watermark处理器默认用黑底白字，若原图背景浅，需加text_color=(0, 0, 0)；position支持'center'、'top-left'等字符串，不支持坐标元组。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
自定义Processor实现透明度可控的文字水印
官方Watermark不支持调整文字透明度（opacity参数实际只影响水印图层，不控制文字本身alpha），要精细控制得自己写Processor：
from PIL import Image, ImageDraw, ImageFont
from io import BytesIO
from django.core.files.base import ContentFile
from imagekit.processors import ImageProcessor
<p>class TextWatermark(ImageProcessor):
def <strong>init</strong>(self, text, font_path=None, font_size=24,
color=(255, 255, 255), alpha=128,
position='bottom-right'):
self.text = text
self.font_path = font_path
self.font_size = font_size
self.color = color
self.alpha = alpha
self.position = position</p><pre class='brush:python;toolbar:false;'>def process(self, img):
draw = ImageDraw.Draw(img)
try:
font = ImageFont.truetype(self.font_path, self.font_size)
except OSError:
font = ImageFont.load_default()
# 获取文字尺寸
text_w, text_h = draw.textsize(self.text, font)
# 计算位置（简化版，仅支持四角和居中）
pos_map = {
'top-left': (10, 10),
'top-right': (img.width - text_w - 10, 10),
'bottom-left': (10, img.height - text_h - 10),
'bottom-right': (img.width - text_w - 10, img.height - text_h - 10),
'center': ((img.width - text_w) // 2, (img.height - text_h) // 2)
}
x, y = pos_map.get(self.position, pos_map['bottom-right'])
# 创建透明文字图层
txt = Image.new('RGBA', img.size, (0, 0, 0, 0))
txt_draw = ImageDraw.Draw(txt)
txt_draw.text((x, y), self.text, font=font, fill=(*self.color, self.alpha))
# 合成
if img.mode != 'RGBA':
img = img.convert('RGBA')
out = Image.alpha_composite(img, txt)
return out.convert('RGB') if 'A' in img.mode else out用法：把TextWatermark放进ImageSpecField的processors列表，alpha=64比默认128更淡，适合浅色背景。
生成缩略图时忽略EXIF方向导致图片歪斜
手机拍的照片常带EXIF Orientation标记，Pillow默认不自动旋转，直接thumbnail()会生成歪图。Django ImageKit默认也不处理——这是最隐蔽的坑。
解决方法只有两个：
- 在自定义Processor里加
img = ImageOps.exif_transpose(img)（Pillow 8.0+），放process()开头 - 用
django-versatileimagefield替代imagekit，它内置EXIF校正，但API风格不同，迁移成本高
别信网上“用img._getexif()手动判断旋转”的方案——_getexif()返回None很常见，且不同厂商Tag ID不统一，稳定性和exif_transpose没法比。
水印和缩略图看着是视觉活，但卡点永远在存储抽象、EXIF、字体路径这三处。漏掉任一个，上线后用户上传一张图，整张页面就崩掉。
