Qwen-Agent项目运行报错问题分析与解决方案

问题现象

在使用Qwen-Agent项目时，用户执行run_server.py启动服务后遇到两个主要问题：

1. 控制台报错显示"ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your network settings to allow access to localhost."

2. 浏览器访问http://127.0.0.1:7864/时提示"无法访问此页面127.0.0.1已拒绝连接"

问题分析

1. Gradio启动问题

这个问题的根本原因是Gradio框架在检测本地服务可达性时失败。当系统设置了网络配置，而Gradio使用的HTTPX库不支持读取系统网络排除列表时，HTTPX会将本地请求(localhost/127.0.0.1)错误地发送到外部服务器，导致可达性检查失败。

2. Ollama API兼容性问题

在Windows/WSL2环境下，Ollama对OpenAI API的兼容性实现存在问题，访问http://127.0.0.1:11434/v1/会返回404错误，这表明API端点未能正确响应。

解决方案

1. 依赖版本调整

首先需要调整项目依赖版本，确保各组件兼容：

1. 修改requirements.txt文件：

   • 移除原有numpy依赖
   • 添加以下依赖项：

     scikit-image>=0.16.1
     protobuf>=3.20.2
     numpy<1.28.0,>=1.21.6
     

2. 重新安装依赖：

   pip install -e ./
   pip install -U "gradio==4.21.0" "modelscope-studio>=0.2.1"
   

2. 代码修改

修改以下两个文件，在launch()方法中添加share=True参数：

1. workstation_server.py
2. assistant_server.py

修改后的代码示例：

demo.queue().launch(share=True)

3. 网络配置处理

对于网络环境下的问题，可以通过以下代码设置网络排除列表：

import os
from urllib.request import getproxies

proxies = getproxies()
os.environ["HTTP_PROXY"] = os.environ["http_proxy"] = proxies["http"]
os.environ["HTTPS_PROXY"] = os.environ["https_proxy"] = proxies["https"]
os.environ["NO_PROXY"] = os.environ["no_proxy"] = "localhost, 127.0.0.1/8, ::1"

4. 启动命令

使用以下命令启动服务：

python run_server.py --model_server http://localhost:11434/v1 --api_key ollama --llm qwen2:latest --server_host 0.0.0.0 --workstation_port 7864

注意事项

1. Windows/WSL2环境下，Ollama对OpenAI API的兼容性可能存在问题，建议在Linux原生环境下运行以获得最佳兼容性。

2. 如果仍然遇到连接问题，可以尝试：

   • 检查防火墙设置，确保相关端口未被阻止
   • 临时关闭杀毒软件测试
   • 检查是否有其他服务占用了7864端口

3. 对于生产环境，建议使用更稳定的部署方式，如Docker容器化部署。

通过以上步骤，应该能够解决Qwen-Agent项目在Windows环境下的运行问题。如果问题仍然存在，建议查看详细的日志输出或联系项目维护者获取进一步支持。