gpt4free LMArena 报错修不好？按症状三步自助恢复-平芜编程栈

gpt4free LMArena 报错修不好？按症状三步自助恢复

【免费下载链接】gpt4freeThe official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4free

发一句"帮我写个周报模板"，控制台直接吐回MissingAuthError: No authentication arguments found.，模型列表一片空白。gpt4free 是免登录调用 GPT-5、Gemini、Claude 的免费开源库，LMArena 是它接 arena.ai 模型竞技场的通道。看完本文，不翻源码就能自助修好 LMArena 通道的四类报错。

快速定位：15 秒锁定你所在的节

报错含MissingRequirementsError: No auth file found and nodriver is not available.→ 去 §缺依赖
报错含MissingAuthError: No authentication arguments found.，或浏览器弹窗后卡住、日志反复刷waiting for authenticate→ 去 §登录缓存
报错含ModelNotFoundError: Model 'xxx' is not supported by LMArena provider.→ 去 §模型名单
日志出现LMArena: Cloudflare error，请求反复失败 → 去 §验证拦截
以上都没命中 → 直接去 §兜底重置

这些错误类的具体定义都能在 g4f/errors.py 里查到。

No auth file found and nodriver is not available：缺依赖

原因：LMArena 通道靠两个库跑。curl_cffi（模拟浏览器指纹发请求的 HTTP 库）和zendriver（一个无头浏览器驱动，负责弹出窗口自动完成网页登录）。代码的策略是"能导入就用，导入不了就报错"，缺一个就抛这个错。zendriver不在requirements.txt里，单独装在 setup.py 的附加依赖清单里，只跑安装基础依赖的命令会漏掉它。

验证：项目目录跑pip list | grep -E "curl_cffi|zendriver"，预期两个包都列出来。

修复：

pip install -r requirements.txt，装上 curl_cffi 等基础依赖
pip install zendriver，若装不上，多半是 Python 低于 3.9，先升级 Python
python -c "import curl_cffi"，无输出即通过

确认：再发一轮对话，不再报MissingRequirementsError。

依赖补齐后如果接着报认证错误，说明卡在下一节。

MissingAuthError：gpt4free LMArena 报错缺登录缓存

原因：这个通道把 arena.ai 的登录凭据（cookies 加请求头）存成本地auth_LMArena.json。文件不存在，或首次登录没走完，请求直接抛MissingAuthError: No authentication arguments found.。完整登录流程在 g4f/Provider/needs_auth/LMArena.py 里。

验证：先python -c "from g4f.cookies import get_cookies_dir; print(get_cookies_dir())"拿到 cookies 目录（默认在用户主目录的~/.g4f/cookies），看里面有没有auth_LMArena.json。健康文件内容是合法 JSON，含 cookies 和 headers。

修复：

文件存在但是空或乱码，先删掉它——这只是运行时凭据缓存，下次登录会自动重新生成
随便发一个 LMArena 请求，触发登录窗口
在窗口里手动完成登录和人机验证，等输入框可用
日志出现Save args to cache file，说明凭据已写入

确认：文件存在、JSON 合法，新一轮对话能出字。

登录走通了还报模型相关错误，问题在名单那一层。

ModelNotFoundError：模型名不在实时名单里

原因：这条通道的模型名单不是写死在代码里的。每次从 arena.ai 首页实时抓取，并往 cookies 目录下的.models子目录存一份缓存。你填的名字不在名单里（大小写敏感），就报ModelNotFoundError: Model 'xxx' is not supported by LMArena provider.。改代码里的 models 数组没有任何效果。

验证：python -c "import g4g; print(g4g.Provider.LMArena.get_models())"，预期返回非空列表，且包含你要的模型名。

修复：