FastAPI中查询字符串#缺失问题排查求助

问题根源 #

#在URL中默认是片段标识符（锚点）的起始标记，浏览器或HTTP客户端会将#及后续内容视为页面内定位信息，不会发送给服务器。虽然前端已将#编码为%23，第一个服务能正常接收，但通过request.query_string转发给第二个服务时出现丢失，核心原因是：

• 直接拼接request.query_string时，若中间环节对其进行了不必要的解码（将%23还原为#），会导致第二个服务的HTTP服务器将#后的内容截断。
• 部分HTTP客户端或代理框架在处理URL时，会自动解析未编码的#，引发参数丢失。

解决方案 #

1. 解析参数后重构请求（推荐）

不要直接转发原始request.query_string，而是先解析当前请求的查询参数，再用HTTP客户端自动编码并转发，避免编码错误。示例代码：

from fastapi import FastAPI, Request
import httpx

app = FastAPI()

@app.get("/forward")
async def forward_request(request: Request):
    # 解析当前请求的所有查询参数
    query_params = dict(request.query_params)
    # 用httpx转发请求，自动处理参数编码
    async with httpx.AsyncClient() as client:
        resp = await client.get("http://second-service/target", params=query_params)
    return resp.json()

这种方式下，httpx会自动将参数中的#转换为%23并正确传递，确保第二个服务完整接收。

2. 直接转发编码后的查询串（需谨慎）

如果必须使用request.query_string，需确保转发时不修改其编码状态：

from fastapi import FastAPI, Request
import httpx

app = FastAPI()

@app.get("/forward")
async def forward_request(request: Request):
    # 获取原始编码后的查询字节串，解码为字符串
    encoded_query = request.query_string.decode("utf-8")
    # 直接拼接到目标URL的?后，确保编码状态不变
    target_url = f"http://second-service/target?{encoded_query}"
    async with httpx.AsyncClient() as client:
        resp = await client.get(target_url)
    return resp.json()

注意：必须保证request.query_string是已编码的原始值（如b'search=%23%23%23%23'），解码后是search=%23%23%23%23，不能在转发前对其进行解码还原操作。

3. 检查中间服务的参数处理逻辑

确认第一个服务的代理/转发逻辑中，没有对查询参数做二次解码。例如某些网关框架会自动解析%23为#，导致转发URL中出现未编码的#，引发第二个服务截断参数。

验证步骤 #

• 在第一个服务中打印request.query_string，确认输出为b'search=%23%23%23%23'而非b'search=####'
• 查看转发到第二个服务的请求URL，确认查询部分为search=%23%23%23%23
• 在第二个服务中打印接收的查询参数，确认能完整获取####

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