Python将Excel表格转PNG插入Outlook邮件：共享路径图片红叉问题

问题概述 #

需求：通过Python脚本将Excel文件中的表格转为PNG图片，并插入至Outlook邮件正文。
现象：使用本地桌面路径时代码正常运行；使用共享文件路径（如X:\Stephanie Roth\...）时，邮件中插入的图片显示为红叉，其他功能无异常。
当前出错代码：

file = r'X:\Stephanie Roth\Data_Releases\GDP\GDP_Deflator.xlsm'
file_png = r'X:\Stephanie Roth\Data_Releases\Python\GDP_Deflator.png'
sub = "Macro1.RefreshData"
run_macro(file, sub)

#Step 2 Copy Table
workbook_path = get_file_location(file)
pythoncom.CoInitialize()
excel = win32com.client.DispatchEx('Excel.Application')
wb = excel.Workbooks.Open(workbook_path)
sheet = wb.Sheets['Table']
#excel.Visible = True
copyrange = sheet.Range('D6:G40')
copyrange.CopyPicture(Appearance=1, Format=2)
ImageGrab.grabclipboard().save(file_png)
excel.Quit()

#create outlook email and insert excel content 
image_path = get_file_location(file_png)
html_body = """
    <div>
        Test <br><br>
    </div>
    <div>
        <img src={}></img>
    </div>
"""
outlook = win32com.client.Dispatch('Outlook.Application')  
message = outlook.CreateItem(0)
message.To = "myemail@gmail.com"
message.Subject = "Refreshed GDP Deflator Data"
message.HTMLBody = html_body.format(image_path)
message.Display()
message.Save()  
message.Send()

原因分析 #

Outlook解析HTML邮件的图片路径时，无法直接识别Windows映射盘符格式（X:\...）。共享路径需要转换为符合HTML标准的UNC URL格式，或者通过嵌入式附件的方式引用，否则Outlook会因无法定位图片资源显示红叉。此外，共享路径权限不足、Outlook安全设置禁止外部图片加载也可能引发该问题。

解决方案 #

方案1：转换共享路径为UNC URL格式 #

将映射盘符路径转换为file://///服务器名/共享名/...的URL格式（共5个斜杠：file:/// + UNC路径的2个斜杠），同时处理路径中的空格为URL编码%20。
修改代码中图片路径处理部分：

import win32api, win32netcon

def convert_to_unc_url(path):
    # 提取盘符
    drive = path.split(':')[0]
    try:
        # 获取盘符对应的UNC根路径
        unc_root = win32api.GetVolumePathName(path).replace(f"{drive}:\\", "")
        # 查询共享信息匹配盘符
        for share in win32net.NetShareEnum(None, 2)[0]:
            if share['netname'] == drive:
                full_unc = f"{share['path']}\\{unc_root}"
                # 转换为URL格式，替换反斜杠和空格
                return f"file:///{full_unc.replace('\\', '/').replace(' ', '%20')}"
    except Exception as e:
        print(f"自动转换失败：{e}")
        # 手动替换（需提前知晓X盘对应的UNC根路径）
        return path.replace('X:\\', 'file://///你的服务器名/你的共享名/').replace('\\', '/').replace(' ', '%20')

# 替换原有的image_path赋值
image_path = convert_to_unc_url(file_png)

方案2：将图片作为嵌入式附件引用（更可靠） #

绕过路径问题，直接把图片作为邮件的嵌入式附件，通过CID（内容ID）在HTML正文中引用，无需依赖外部路径：
修改邮件创建部分代码：

outlook = win32com.client.Dispatch('Outlook.Application')  
message = outlook.CreateItem(0)
message.To = "myemail@gmail.com"
message.Subject = "Refreshed GDP Deflator Data"

# 添加图片为嵌入式附件，设置CID
attachment = message.Attachments.Add(file_png)
# 设置附件的Content-ID属性
attachment.PropertyAccessor.SetProperty("http://schemas.microsoft.com/mapi/proptag/0x3712001F", "gdp_deflator_img")

# 构造HTML正文，引用CID
html_body = """
    <div>
        Test <br><br>
    </div>
    <div>
        <img src="cid:gdp_deflator_img">
    </div>
"""
message.HTMLBody = html_body
message.Display()
message.Save()  
message.Send()

方案3：检查权限与Outlook设置 #

• 确保运行脚本的用户对共享路径拥有读取权限；
• 调整Outlook安全设置：依次点击「文件」>「选项」>「信任中心」>「信任中心设置」>「自动下载」，取消勾选「不允许自动下载图片或其他内容」，或把共享路径添加到信任站点列表。

内容的提问来源于stack exchange，提问作者fiona van der steur