如何解决Django项目中用XlsxWriter向Excel插入图片的报错问题？

嘿，我之前在处理Django导出Excel带图片的需求时，也碰到过几乎一模一样的问题，咱们一步步拆解解决：

问题根源分析 #

• 相对路径找不到文件：Django运行时的工作目录是项目根目录（也就是manage.py所在的文件夹），如果你的value是模型里存的相对路径（比如uploads/xxx.png），直接用这个路径的话，程序会从项目根目录开始找，而不是你的app目录或者媒体文件夹，自然找不到。
• 绝对路径权限拒绝：Windows的用户目录（比如C:/Users/username/...）默认权限限制比较严格，Django进程可能没有读取该目录的权限；另外路径里的反斜杠如果没处理好，也可能导致识别错误。

具体解决方案 #

1. 用Django媒体目录拼接正确的绝对路径（最推荐） #

如果你的图片是存在Django配置的MEDIA_ROOT目录下的，直接用配置项拼接绝对路径，既能保证路径正确，又能避开权限坑：

from django.conf import settings
import os

for counter_i, cost in enumerate(costs):
    counter_i += 1
    for counter_j, feature in enumerate(features):
        value = getattr(cost, feature)
        if feature == 'image':
            # 拼接完整的绝对路径
            image_abs_path = os.path.join(settings.MEDIA_ROOT, str(value))
            # 先校验文件是否存在
            if os.path.exists(image_abs_path):
                worksheet.insert_image(counter_i, counter_j, image_abs_path, {'x_offset': 15, 'y_offset': 10})
            else:
                # 文件不存在时的兜底处理
                worksheet.write(counter_i, counter_j, "图片丢失")
        else:
            worksheet.write(counter_i, counter_j, value)

• 注意：确保settings.py里正确配置了MEDIA_ROOT和MEDIA_URL，比如：

  MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
  MEDIA_URL = '/media/'
  

2. 解决自定义目录的权限问题 #

如果图片存在非媒体目录的位置：

• 调整路径格式：Windows路径要么用双反斜杠C:\\Users\\xxx\\xxx.png，要么用原始字符串r'C:\Users\xxx\xxx.png'，避免转义字符导致路径错误。
• 开放目录权限：右键目标文件夹 → 属性 → 安全 → 给当前运行Django的用户（比如本地开发就是你的Windows账号）添加读取和执行权限。
• 更换存储位置：尽量把图片放到项目目录下的自定义文件夹（比如project_root/custom_images），这类目录的权限更容易控制，也不会有用户目录的限制。

3. 调试小技巧 #

在插入图片前先打印路径，确认是否正确：

print("当前要读取的图片路径：", image_abs_path)

然后手动在文件管理器里打开这个路径，验证文件是否存在、能否正常访问，这能快速定位是路径错误还是权限问题。

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