You need to enable JavaScript to run this app. Discord.py 使用本地文件设置Embed缩略图时图片显示在Embed外部的问题
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py 使用本地文件设置Embed缩略图时图片显示在Embed外部的问题

问题根因

故障出在对Discord附件引用规则的误解上。
Discord的Embed如果要加载同一条消息附带的本地文件,attachment://协议后面必须和你初始化discord.File时传入的filename参数完全一致,绝对不能填文件在本地电脑的存储路径。
现有代码里,给上传的文件指定的文件名是image.png,但设置缩略图时填的地址是本地路径file_location/file.png,两者不匹配,Discord找不到对应的附件资源,自然没法把图渲染到Embed的缩略图槽位,只能把图片当成独立的普通附件发出去。

修正后的可用代码
embedVar = discord.Embed(
    title="title",
    description="desc.",
    color=0x19A6FF
)
# 读取本地文件,指定上传时使用的文件名
file = discord.File("file_location/file.png", filename="image.png")
# attachment://后直接填上面指定的filename值
embedVar.set_thumbnail(url="attachment://image.png")
await message.channel.send(file=file, embed=embedVar)
常见踩坑提醒
  • 不需要手动对attachment://后面的文件名做URL编码,discord.py会自动处理格式适配
  • 哪怕给文件起的名字带空格、中文或者特殊符号,只要前后写的完全一致,就可以正常加载
  • 别把本地文件的绝对路径(比如/home/xxx/pic.png、C:/Users/xxx/pic.png)拼到attachment://后面,哪怕路径本身没错,也会匹配失败
  • 确保本地文件的路径是程序当前有权限访问的,避免触发读取文件的报错

内容的提问来源于stack exchange,提问作者Loboh67

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 12:45:03