Django配置MEDIA_ROOT时出现路径类型错误与os未定义报错的原因及解决

第一类报错：_getfullpathname: path should be string, bytes or os.PathLike #

报错原因 #

你最初配置的MEDIA_ROOT = [BASE_DIR, 'static/images']传入的是Python列表类型，不符合Django对MEDIA_ROOT的格式要求。Django处理文件上传时，会将MEDIA_ROOT作为文件落地的根目录，这个参数要求必须是字符串、字节或者系统可识别的路径类对象，当底层调用系统路径解析方法拿到列表类型的值时，就会触发类型不匹配的报错。

额外提示：你写的STATICFILES_DIRS = [BASE_DIR, 'static']存在同类格式错误，该配置的作用是聚合项目内所有静态文件目录，要求列表的每个元素都是完整的静态文件路径，当前写法是把拼接路径的两个片段拆成了独立列表项，会导致静态文件路径识别失效。

第二类报错：NameError: name 'os' not defined #

报错原因 #

你修改配置时使用了os.path.join(BASE_DIR, 'static/images')来生成合法路径，但没有在settings.py的代码头部导入os模块，Python执行到该行时找不到os模块的定义，就会抛出名称未定义的错误。

正确配置操作步骤 #

• 在settings.py的最顶部添加os模块导入语句：import os
• 修正所有路径相关的错误配置：
  • 将原来错误的MEDIA_ROOT = [BASE_DIR, 'static/images']替换为MEDIA_ROOT = os.path.join(BASE_DIR, 'static/images')
  • 将原来写错的媒体URL配置项MEDIA = '/images/'修正为标准配置MEDIA_URL = '/images/'，避免Django无法识别媒体文件的访问路径
  • 将错误的静态文件目录配置STATICFILES_DIRS = [BASE_DIR, 'static']修正为STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
• models.py中的Customer模型配置无需额外调整，配置修正完成后ImageField就可以正常完成图片上传、存储逻辑。

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