根本原因是pillow默认仅支持ascii字符，未显式加载含中文字符集的truetype字体文件（如simhei.ttf），导致调用imagedraw.text()时静默渲染为方块或空白。
用 Pillow 给图片加文字水印时中文显示为空白或方块
根本原因是 Pillow 默认不支持中文字体，直接调用 ImageDraw.text() 传入中文字符串会渲染失败（可能报 UnicodeEncodeError 或静默显示为空白/方块）。
- 必须显式加载一个支持中文的字体文件（如系统自带的
simhei.ttf、msyh.ttc，或项目内嵌的NotoSansCJK-Regular.ttc） - 路径要确保 Flask 应用能读取：推荐放在
static/fonts/下，并用os.path.join(app.root_path, 'static', 'fonts', 'simhei.ttf')构造绝对路径 - 字体大小不能为 0 或过小，否则在高 DPI 图片上不可见；建议至少
size=24 - 示例片段：
from PIL import Image, ImageDraw, ImageFont font = ImageFont.truetype(font_path, size=32) draw.text((10, 10), "© 2024", font=font, fill=(255, 255, 255, 128))
Flask 接收上传图片后加水印并返回，但原图格式丢失或变成 PNG
常见于用 image.save(io.BytesIO(), format='PNG') 硬编码格式，导致 JPEG 上传后返回 PNG，体积变大、颜色偏移甚至透明背景异常。
- 从原始
FileStorage对象读取时，先用PIL.Image.open(file_stream)打开，再通过img.format获取原始格式（如'JPEG'、'PNG'、'WEBP'） - 保存时显式传入
format=img.format，并注意 JPEG 不支持 alpha 通道：若水印含透明度，需先img = img.convert('RGB') - 对 WebP / GIF 等多帧图像，
Pillow默认只处理第一帧；如需保留动图水印，得手动遍历img.n_frames并逐帧处理（复杂度陡增，一般建议仅处理静态图）
水印位置固定在左上角，但实际需要居中/右下角/平铺
硬写坐标 (10, 10) 无法适配不同尺寸图片。关键在于根据原图 img.size 动态计算位置，且要考虑水印文本/图像的实际像素宽高。
- 文字水印：用
font.getbbox(text)（Pillow ≥ 8.0）或draw.textsize(text, font)（旧版）获取宽高，再结合目标位置反推坐标 - 右下角示例：
text = "CONFIDENTIAL" bbox = font.getbbox(text) text_width, text_height = bbox[2] - bbox[0], bbox[3] - bbox[1] x = img.width - text_width - 10 y = img.height - text_height - 10
- 平铺水印：需用
Image.new('RGBA', img.size)创建透明图层，循环绘制多个水印，再用Image.alpha_composite(img.convert('RGBA'), overlay)
并发上传时水印处理阻塞主线程，响应变慢
Flask 默认单线程开发服务器 + 同步 Pillow 图像操作，一张 4K 图加水印可能耗时 300–800ms，多用户同时上传会排队等待。
- 生产环境务必使用
gunicorn或uWSGI启动多 worker（如--workers 4），避免单进程瓶颈 - 对大图，可提前缩略或降低质量：
img.save(..., quality=85, optimize=True)减少 I/O 和内存压力 - 更彻底的解法是异步化：用
celery将水印任务扔进队列，API 立即返回任务 ID，前端轮询结果；但需额外维护消息队列和 worker 进程
水印功能看似简单，真正上线时最容易被忽略的是字体路径的跨环境兼容性（开发机有 simhei.ttf，Docker 容器里没有）、原始格式保持逻辑（尤其 JPEG 的 RGB 转换时机），以及高并发下 Pillow 的 CPU 密集型操作对响应时间的冲击。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
