Django使用django-vimeo时Admin编辑报'NoneType' object is not iterable错误求助

问题根因定位 #

该错误是django-vimeo组件渲染Admin编辑页的VimeoField控件时触发，组件调用Vimeo API获取视频元数据失败返回None，后续渲染逻辑尝试遍历该None对象导致报错，和你本地数据库的Video记录是否存在无关。

修复步骤 #

1. 检查Vimeo配置有效性
   确认settings.py中已配置3个必填参数，且值均为Vimeo开发者后台生成的有效凭证：

VIMEO_ACCESS_TOKEN = '你的有效access token'
VIMEO_CLIENT_KEY = '你的client key'
VIMEO_CLIENT_SECRET = '你的client secret'

同时确认你的Vimeo账号状态正常，该access token拥有目标视频的访问权限。

2. 修正存量字段存储格式
   VimeoField字段要求存储Vimeo视频的标准URI格式（如/videos/123456789），如果你的旧数据存储的是纯数字ID、直链等非标准格式，组件调用API时会返回空值。你可以批量修正存量数据格式：

# 进入Django shell执行
from 你的应用名.models import Video
for obj in Video.objects.all():
    if obj.video and not obj.video.startswith('/videos/'):
        obj.video = f'/videos/{obj.video.strip()}'
        obj.save()

3. 版本兼容适配
   如果你的Django版本低于3.2，需降级django-vimeo到兼容版本：

pip install django-vimeo==0.4.2

4. 临时规避方案
   如果暂时不需要在Admin编辑Vimeo字段，可以直接在Admin配置中把该字段设为只读或者隐藏：

# admin.py
from django.contrib import admin
from .models import Video

class VideoAdmin(admin.ModelAdmin):
    readonly_fields = ('video',)
    # 不需要展示的话可以用 exclude = ('video',)

admin.site.register(Video, VideoAdmin)

验证方法 #

你可以在Django shell中执行以下代码快速验证API调用是否正常：

from 你的应用名.models import Video
v = Video.objects.first()
print(v.video) # 确认输出为合法URI格式
print(v.video.metadata) # 正常会返回视频元数据字典，报错则说明API调用失败

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