text-generation-webui的--listen-port参数失效且启动报错求助

核心原因 #

报错AttributeError: module 'gradio' has no attribute 'Box'是因为当前安装的Gradio版本过低，gr.Box是Gradio 3.0及以上版本才引入的组件，旧版本不支持该特性，导致WebUI初始化失败——服务根本没启动起来，自然无法通过IP访问。

解决步骤 #

1. 卸载当前低版本Gradio

pip uninstall -y gradio

2. 安装适配text-generation-webui的Gradio版本
   • 优先使用项目自带的依赖文件安装，确保版本完全匹配：

   pip install -r requirements.txt
   

   • 若单独安装，可尝试安装经过验证的兼容版本（比如3.35.2）：

   pip install gradio==3.35.2
   

3. 重新执行启动命令

python server.py --listen-port 7860 --listen-host 0.0.0.0 --share

后续访问排查 #

若服务正常启动后仍无法通过192.XXX.XXX.XXX:7860访问：

• 检查本地防火墙是否开放了7860端口
• 确认设备处于同一局域网，且IP地址输入正确

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