使用openapi-python-client生成API客户端遇httpx连接拒绝问题求助

针对你遇到的httpx.ConnectError: [Errno 111] Connection refused错误，按以下步骤排查：

• 确认目标API服务是否运行
  直接通过浏览器或curl访问目标接口地址（比如curl http://0.0.0.0:8002/authentication/user/），如果同样返回连接拒绝，说明API服务未启动，先启动服务。另外可以尝试用127.0.0.1代替0.0.0.0，部分环境下0.0.0.0无法直接作为访问地址。

• 检查端口是否匹配
  核对API服务的监听端口是否为8002，查看服务启动日志或配置文件，避免端口填写错误。

• 排查端口占用情况
  用命令检查8002端口是否被其他程序占用：

  • Linux/macOS：lsof -i :8002
  • Windows：netstat -ano | findstr :8002
    如果有其他程序占用，要么停止该程序，要么修改API服务或客户端的端口。

• 验证网络与防火墙设置
  如果API服务在远程机器，确认目标机器防火墙开放了8002端口，且当前机器与目标机器网络连通。本地服务则检查系统防火墙是否拦截了端口访问。

• 跳过客户端直接测试连接
  用httpx直接发起请求，排除客户端代码问题：

  import httpx
  try:
      response = httpx.get("http://0.0.0.0:8002/authentication/user/", verify=False)
      print(f"请求成功，状态码: {response.status_code}")
  except Exception as e:
      print(f"错误详情: {e}")
  

  如果这个测试也报错，问题出在网络或服务本身；如果测试成功，再检查生成的客户端代码中接口路径是否与实际API匹配。

内容的提问来源于stack exchange，提问作者Alberto Sanmartin Martinez