使用Python Pillow合成头像与相框时遇透明蒙版错误求助

错误原因分析 #

1. 你的头像资源是JPG格式，没有Alpha通道，但代码中直接将avatar作为paste()方法的mask参数。Pillow要求mask必须是单通道灰度图（L模式）或带Alpha通道的RGBA图，且尺寸需与被粘贴图像完全一致，JPG的RGB模式无法满足这个要求，因此触发错误。
2. 代码中size变量未定义，必须明确设置为目标尺寸(512, 512)。

修正后的代码 #

from PIL import Image

def create_avatar(username):
    avatar, frame, avatar_id = get_avatar(username)
    target_size = (512, 512)  # 明确目标尺寸
    if avatar is not None and frame is not None:
        try:
            # 创建透明背景的目标图
            image = Image.new("RGBA", target_size, (0, 0, 0, 0))

            # 处理头像：将JPG转RGBA，确保可以正确生成mask
            avatar_rgba = avatar.convert("RGBA")
            # 用头像的灰度图作为mask（如果头像本身不透明，也可以直接不传mask，但转RGBA更稳妥）
            avatar_mask = avatar_rgba.split()[-1] if avatar_rgba.mode == "RGBA" else avatar_rgba.convert("L")

            # 粘贴头像到指定位置，使用正确的mask
            image.paste(avatar_rgba, (157, 160), avatar_mask)

            # 处理边框：确保是RGBA模式，尺寸匹配目标图
            frame_rgba = frame.convert("RGBA").resize(target_size)
            frame_mask = frame_rgba.split()[-1]
            # 粘贴边框
            image.paste(frame_rgba, (0, 0), frame_mask)
        except Exception as e:
            print(e)
            image = Image.open("images/unknown_avatar.png").resize(target_size)
    elif avatar is not None:
        # 直接使用头像并调整尺寸
        image = avatar.convert("RGBA").resize(target_size)
    else:
        image = Image.open("images/unknown_avatar.png").resize(target_size)

    image.save(f'images/{username}.png', format='png')

关键修正点 #

• 明确设置target_size = (512, 512)，确保输出尺寸符合要求
• 将JPG头像转换为RGBA模式，避免因无Alpha通道导致的mask错误
• 单独提取或生成符合要求的mask（单通道灰度图），传递给paste()方法
• 确保边框图也转换为RGBA并调整到目标尺寸，避免尺寸不匹配问题

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