快速结论:这个报错通常出现在启动 Stable Diffusion WebUI Forge 时,Gradio 无法访问 localhost,于是要求创建 shareable link。优先排查本机代理设置,尤其是 no_proxy 是否包含 localhost 与 127.0.0.1。
适用环境:Issue 中确认的是 Stable Diffusion WebUI Forge;涉及的启动脚本为 webui-user.bat;Issue 讨论中提到的依赖为 pydantic。Issue 未提供操作系统、Python、CUDA、PyTorch、显卡等具体版本信息。
最快修复方案:Issue 评论中给出的做法是:用 Visual Studio 等代码阅读/编辑器打开 webui-user.bat,手动加入 set no_proxy=localhost, 127.0.0.1, ::1。
注意事项:该做法来自社区评论,属于用户自行验证可行的绕过方式,不是官方结论;若同时存在系统级代理、HTTP_PROXY/HTTPS_PROXY 或其他网络工具,仍可能影响 Gradio 访问 localhost。评论中另提到可尝试降级 pydantic==2.10.6,但 Issue 未确认这一步能解决本问题,可优先尝试。
问题场景
用户在启动 Stable Diffusion WebUI Forge 时,Gradio 启动阶段检测到无法访问 localhost,抛出 ValueError 并中止。该问题与启动脚本、代理环境以及 Gradio 本机回环访问有关,不涉及具体的模型、采样节点或生成流程。
报错原文
ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your proxy settings to allow access to localhost.
原因分析
最可能的原因是当前环境中的代理设置没有把 localhost、127.0.0.1 和 ::1 排除在代理之外,导致 Gradio 无法直接访问本机回环地址。Issue 评论中引用了 TaskMatrix 的相关讨论,并指出需要在 webui-user.bat 中显式设置 no_proxy。另有评论提到 pydantic 版本可能相关,并建议尝试 pydantic==2.10.6,但该方向在 Issue 中没有被明确确认。
环境排查
- 确认启动脚本:是否使用
webui-user.bat启动 Stable Diffusion WebUI Forge。 - 确认代理变量:检查系统中是否设置了
HTTP_PROXY、HTTPS_PROXY或类似代理变量。 - 确认 no_proxy:检查
no_proxy是否包含localhost、127.0.0.1、::1。 - 确认依赖版本:Issue 评论提到 pydantic,可检查当前 pydantic 版本是否与评论中的
2.10.6不一致;但 Issue 未给出该版本必然有效的结论。 - 确认编辑器方式:Issue 评论建议用 Visual Studio 等代码阅读程序打开脚本,而不是仅用记事本,以便正确编辑启动脚本。
解决步骤
- 用 Visual Studio 或其他代码编辑器打开 Stable Diffusion WebUI Forge 目录下的
webui-user.bat。 - 在脚本中手动加入:
set no_proxy=localhost, 127.0.0.1, ::1。Issue 评论指出,这正是用户需要手动补充的内容。 - 保存脚本并重新运行
webui-user.bat,观察 Gradio 是否仍抛出该 ValueError。 - 如果问题仍然存在,可优先尝试评论中提到的降级 pydantic 到
2.10.6,但需注意这并非 Issue 已确认的因果修复。
验证方法
重新启动 Stable Diffusion WebUI Forge 后,如果不再出现 ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your proxy settings to allow access to localhost.,并且 Gradio 能正常启动本地 WebUI 界面,即可认为该问题已解决。若仍报错,说明代理或依赖层面可能还有其他因素。
参考来源
lllyasviel/stable-diffusion-webui-forge #1479
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。
![[BUG]: Speak Your Prompt isn't working](https://www.chat-gpts.plus/wp-content/uploads/2026/09/2298-333fe16e-768x403.jpg)
![[BUG]: incapable of updating](https://www.chat-gpts.plus/wp-content/uploads/2026/09/6169-6bb93e3f-768x403.jpg)
![[Bug]: rust-wheel OCR callback test expects swallowed logger exception to propagate](https://www.chat-gpts.plus/wp-content/uploads/2026/09/42714-55ab3a70-768x403.jpg)