FastAPI搭建模拟服务器实现跨服务认证握手时报httpcore异常如何解决

核心触发原因 #

• URL格式不合法
  你代码中所有httpx.get的目标地址缺少HTTP/HTTPS协议头、服务监听端口、完整路径前缀，比如httpx.get("server1/authorize")不符合标准URL规范，httpx无法解析目标服务地址，直接触发httpcore底层的地址解析异常。正确写法需要补全完整URL，例如Server1启动在8000端口的话，请求地址应该写为httpx.get("http://127.0.0.1:8000/v1/authorize")。

• 路由定义错位
  /callback端点的路由你写在了Server2的代码中，但Server1的do_authorize函数逻辑是调用自身的/callback接口，Server1没有定义该路由，请求会返回404状态码，触发httpcore的响应状态异常。你需要把/callback的路由定义移到Server1的代码文件中。

• 同步路由阻塞导致超时
  你当前写的所有路由函数都是同步函数（没有async关键字），FastAPI默认使用单工作线程处理同步请求：当Server1收到/v1/authorize请求时，会占用唯一的工作线程处理该请求，此时你在处理逻辑中再发起请求调用自身的/callback接口，该新请求没有空闲工作线程可以处理，会一直阻塞直到超时，触发httpcore的超时异常。

修复方案 #

两种方案二选一即可：

1. 全链路改用异步实现
   把所有路由函数改成异步函数，搭配httpx异步客户端发请求，示例代码如下：

# Server1 main.py 示例
import httpx
from fastapi import FastAPI

app = FastAPI()
async_client = httpx.AsyncClient()

@app.get("/v1/authorize")
async def do_authorize():
    # 替换为你实际的Server1回调地址
    await async_client.get("http://127.0.0.1:8000/callback")
    return "OK"

@app.get("/callback")
async def do_callback():
    return "OK"

# Server2 main.py 示例
import httpx
from fastapi import FastAPI

app = FastAPI()
async_client = httpx.AsyncClient()

@app.get("/v1/connect")
async def connect():
    # 替换为你实际的Server1授权接口地址
    await async_client.get("http://127.0.0.1:8000/v1/authorize")
    return "OK"

2. 增加服务工作线程数
   启动FastAPI服务时添加--workers参数增加工作进程数，或者用--limit-concurrency参数调整并发限制，预留足够的线程处理嵌套请求，示例启动命令：

uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4

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