PythonFlask加水印教程：Pillow图片处理技巧

本文深入解析了在 Flask 框架中使用 Pillow 为图片添加中文水印的完整实践与常见陷阱，重点破解了中文显示为空白或方块的根本原因——Pillow 默认不支持中文字体，必须显式加载如 simhei.ttf 等中文字体文件并确保路径跨环境可用；同时系统梳理了格式丢失、多帧动图处理、动态定位（居中/右下角/平铺）、高并发性能瓶颈等生产级问题，并给出可落地的解决方案：基于原图格式智能保存、RGB 转换规避 Alpha 冲突、利用 getbbox 动态计算坐标、多 worker 部署及异步任务队列优化。这不仅是一份技术教程，更是从开发到上线全链路避坑指南。

用 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 密集型操作对响应时间的冲击。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PythonFlask加水印教程：Pillow图片处理技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。