FastAPI 调用第三方接口 403 排查实战：从百炼 LLM 到 apimy.cn 学历验证

本文记录一个 FastAPI 项目（yujhg后端）在接入「阿里云百炼 DashScope LLM」与「apimy.cn 学历验证接口」时，连续踩中的 6 个 403 / 400 坑，以及逐个定位、修复的完整过程。希望能帮到同样被403 请求密钥KEY不正确、403 Workspace endpoint access denied、400 enable_thinking折磨过的同学。

---

一、背景与环境

• 后端框架：FastAPI + Tortoise ORM + Pydantic Settings
• LLM：阿里云百炼 DashScope（OpenAI 兼容模式），模型qwen-plus
• 第三方工具接口：apimy.cn 学历信息核验https://www.apimy.cn/api/xxw/bgcx
• 缓存：Redis（case6.py未指定 db，默认db=0；项目主配置REDIS_DB=8）
• 核心脚本：app/apis/llm/case6.py，演示「LLM 自动决定调用学历验证工具」的 function calling 流程

敏感信息说明：本文所有 API Key、学历验证码均已脱敏。示例验证码原文已删除两个字母，请在实际部署时替换为你自己的真实学信网验证码；所有 Key 仅保留前后缀示意，切勿照搬。

---

二、问题一：调用百炼 LLM 报 403 / 400

2.1 现象：403 Workspace endpoint access denied

接口GET /job/resume_submission_detail/{id}报错：

openai.PermissionDeniedError: 403 Workspace endpoint access denied

根因有两点：

1. 代码用os.getenv("DASHSCOPE_API_KEY")读密钥，但项目用 Pydantic Settings 加载.env（不会自动注入os.environ），因此读不到。
2. 原base_url指向了错误的私有 MaaS 工作空间端点llm-pz0prcj5mohy7yjg...maas.aliyuncs.com，而当前 Key 属于ws-qi62pydskr7khowk工作空间，无权访问旧空间 → 403。

2.2 现象：400 enable_thinking must be set to false

密钥修对后又报新错：

openai.BadRequestError: 400 - parameter.enable_thinking must be set to false for non-streaming calls

含义：qwen-plus/qwen3等推理模型，DashScope 规定非流式调用必须关闭 thinking，流式调用可保留。

2.3 修复方案

app/config/settings.py的BaseAppSettings增加配置项：

# 阿里云百炼（DashScope）LLM 配置DASHSCOPE_API_KEY:str=""LLM_BASE_URL:str="https://dashscope.aliyuncs.com/compatible-mode/v1"LLM_MODEL:str="qwen-plus"APIMY_KEY:str=""# 第三方 apimy.cn 密钥

.env.dev关键配置（Key 已打码）：

# 阿里云百炼（DashScope）LLM 配置 # 把 DASHSCOPE_API_KEY 替换为你自己的百炼 API Key DASHSCOPE_API_KEY=sk-ws-H.ELLHXEP****_j0 # 使用你的 MaaS 工作空间端点（空间ID: ws-qi62pydskr7khowk） LLM_BASE_URL=https://ws-qi62pydskr7khowk.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 LLM_MODEL=qwen-plus # 梦远数据（apimy.cn）学历验证密钥（已打码，请替换为你自己的 key） APIMY_KEY=MY_KEY_Sl0nSl****PfP

LLM 调用改为配置驱动 + 非流式关闭 thinking：

fromapp.config.settingsimportsettingsfromopenaiimportAsyncOpenAI client=AsyncOpenAI(api_key=settings.DASHSCOPE_API_KEY,base_url=settings.LLM_BASE_URL,)completion=awaitclient.chat.completions.create(model=settings.LLM_MODEL,messages=messages,# 非流式调用必须关闭 thinking，否则 DashScope 报 400extra_body={"enable_thinking":False},)

经验：配置改完后若报错从 403 变成 400/其他新错，说明uvicorn --reload已加载新代码，无需手动重启；只有仍报原始 403 才代表旧进程未重载。但注意：改.env文件不会触发--reload（它只监控.py），要让.env生效需手动重启 uvicorn。

---

三、问题二：apimy.cn 学历验证报403 请求密钥KEY不正确（重点）

这是本文的重头戏。case6.py通过 function calling 让 LLM 决定调用academic_credential_verification工具，工具内部请求 apimy.cn，却一直返回：

{"code":403,"msg":"请求密钥KEY不正确！请在用户控制台 https://www.apimy.cn/user/key 免费申请，或联系在线客服","data":null}

排查过程中，我连续踩了5 个坑，逐个拆解如下。

坑 1：key 放错位置（JSON body 是错的）

一开始代码把 key 和 vcode 一起塞进JSON body：

# ❌ 错误：apimy.cn 读不到 JSON body 里的 keyrequests.post(url,json={"key":apimy_key,"vcode":vcode})

apimy.cn 接口要求：key 放 URL 查询参数，vcode 放表单体：

# ✅ 正确requests.post(BASE_URL,params={"key":apimy_key},# key 在 URL 查询参数data={"vcode":vcode},# vcode 在表单体timeout=30,)

坑 2：.env.dev里的 key 本身就填错了

即使格式改对，仍 403。最后发现：.env.dev里填的 key（MY_KEY_S10nSIkoM8TKXNu3txIBiZ8H0epPFP）与真正可用的 key 不一致。

关键点：apimy.cn 这类平台是「每接口一个密钥」模式，学历查询接口需要去该接口页单独申请专属 key，通用控制台 key 未必对所有接口生效。最终可用的 key 形如MY_KEY_Sl0nSl****PfP（已打码），把它填进.env.dev的APIMY_KEY=才行。

坑 3：运行目录（cwd）导致.env.dev加载失败

从非项目根目录运行脚本时，LLM 正常（系统环境变量里有DASHSCOPE_API_KEY），但学历工具直接抛：

ValueError: 未配置 APIMY_KEY

根因：Pydantic Settings 的env_file=".env.dev"是相对路径，相对于进程 cwd。cwd 不是项目根时找不到.env.dev，settings.APIMY_KEY取默认空串；而系统环境变量里又没有APIMY_KEY，于是两边皆空。

修复：在脚本顶部强制把项目根加入sys.path并chdir过去，保证任意目录运行都能加载配置：

importos,sys _PROJECT_ROOT=os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))if_PROJECT_ROOTnotinsys.path:sys.path.insert(0,_PROJECT_ROOT)os.chdir(_PROJECT_ROOT)

坑 4：Redis 缓存库选错（db=0 vs db=8）—— 最隐蔽的坑

这个坑让我白查了很久。流程是：

1. 用错误 key跑case6.py→ 拿到 403 →case6.py把这个403写进了Redis 默认库 db=0的缓存键boss:llm:academic_credential_verification:{vcode}。
2. 后来把 key 改对了，但每次运行都命中旧 403 缓存，根本没重新请求 apimy.cn。
3. 排查时我一直用 Redisdb=8清缓存/查缓存（因为.env.dev里REDIS_DB=8），而case6.py的Redis(...)没指定 db（默认 db=0），永远清不到真正生效的那个缓存。

修复：清对库！

importredis r=redis.Redis(host='127.0.0.1',port=6379,db=0,decode_responses=True)# 注意是 db=0r.delete('boss:llm:academic_credential_verification:AR9GK0XA****HKPFZ')# 验证码已脱敏

提示：case6.py有缓存逻辑，换不同 vcode 才走真实接口；同一 vcode 命中缓存。之后每次更换 key，记得清 Redisdb=0下对应缓存键。

坑 5：进程环境变量残留旧 key 覆盖.env.dev

之前用 PowerShell 把APIMY_KEY写进了系统 User 环境变量，但值是旧的、错误的 key。而case6.py里apimy_key = os.environ.get("APIMY_KEY") or settings.APIMY_KEY，环境变量优先级最高，于是.env.dev的正确 key 被旧环境变量覆盖。

修复：在from app.config.settings import settings之前，主动清掉可能残留的旧环境变量：

# 清除可能残留的旧 APIMY_KEY 环境变量，避免用错误密钥请求 apimy.cnos.environ.pop("APIMY_KEY",None)fromapp.config.settingsimportsettings

（同时把系统环境变量APIMY_KEY也更新为正确值做兜底。）

---

四、最终可运行代码（case6.py 完整版）

下文验证码已删除两个字母脱敏为AR9GK0XA****HKPFZ，API Key 也已打码，请替换为你的真实值。

# 初始化客户端importjsonimportosimportrandomimportsys# 无论从哪个目录运行脚本，都把项目根目录加入 sys.path 并切换过去，# 保证能 import app 包，且 pydantic-settings 能按相对路径正确加载 .env.dev_PROJECT_ROOT=os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))if_PROJECT_ROOTnotinsys.path:sys.path.insert(0,_PROJECT_ROOT)os.chdir(_PROJECT_ROOT)importrequestsfromopenaiimportOpenAIfromredisimportRedis# 清除可能残留的旧 APIMY_KEY 环境变量，避免用错误密钥请求 apimy.cnos.environ.pop("APIMY_KEY",None)fromapp.config.settingsimportsettings redis_client=Redis(port=6379,host="127.0.0.1",decode_responses=True)# 模拟天气查询工具defget_current_weather(arguments):weather_conditions=["晴天","多云","雨天"]random_weather=random.choice(weather_conditions)location=arguments["location"]returnf"{location}今天是{random_weather}。"# 学历验证defacademic_credential_verification(arguments):vcode=arguments["vcode"]key=f"boss:llm:academic_credential_verification:{vcode}"redis_verification_data=redis_client.get(key)ifredis_verification_dataisNone:# 优先读 .env.dev 的 settings.APIMY_KEY（已 pop 掉残留环境变量）apimy_key=settings.APIMY_KEYoros.environ.get("APIMY_KEY")ifnotapimy_key:raiseValueError("未配置 APIMY_KEY，请在系统环境变量或 .env.dev 中填写梦远数据 API Key")BASE_URL="https://www.apimy.cn/api/xxw/bgcx"# apimy.cn 要求 key 放在 URL 查询参数、vcode 放在表单体（不能用 JSON body）response=requests.post(BASE_URL,params={"key":apimy_key},data={"vcode":arguments["vcode"]},timeout=30,)response.raise_for_status()data=response.json()redis_client.set(key,json.dumps(data,ensure_ascii=False))returnjson.dumps(data,ensure_ascii=False)else:returnredis_verification_data tools=[{"type":"function","function":{"name":"get_current_weather","description":"当你想查询指定城市的天气时非常有用。","parameters":{"type":"object","properties":{"location":{"type":"string","description":"城市或县区，比如北京市、杭州市、余杭区等。"}},"required":["location"],},},},{"type":"function","function":{"name":"academic_credential_verification","description":"当你想查询学历或者验证学历时非常有用。","parameters":{"type":"object","properties":{"vcode":{"type":"string","description":"学历验证码"}},"required":["vcode"],},},}]client=OpenAI(api_key=settings.DASHSCOPE_API_KEY,base_url=settings.LLM_BASE_URL,)messages=[]defget_ai_response(messages):completion=client.chat.completions.create(model=settings.LLM_MODEL,messages=messages,temperature=0.75,tools=tools,# 非流式调用必须关闭 thinking，否则 DashScope 报 400extra_body={"enable_thinking":False},)returncompletion# 注意：验证码已脱敏（删除两个字母），实际请替换为你的真实学信网验证码user_message={"role":"user","content":"帮我查询一下学历, 验证码是:AR9GK0XA****HKPFZ"}messages.append(user_message)completion=get_ai_response(messages)print(completion.model_dump_json())messages.append(completion.choices[0].message)ifcompletion.choices[0].message.tool_callsisNone:print("不需要调用工具")print(completion.choices[0].message.content)else:print("需要调用工具")tool_calls=completion.choices[0].message.tool_callsfortool_callintool_calls:tool_id=tool_call.idfunc_name=tool_call.function.name func_arguments=tool_call.function.argumentsprint(f"大模型告诉程序要调用这个工具:{func_name},参数是:{func_arguments}")function_mapping={"get_current_weather":get_current_weather,"academic_credential_verification":academic_credential_verification}print(type(func_arguments))tool_result=function_mapping[func_name](json.loads(func_arguments))print(f"工具返回的结果是:{tool_result}")tool_message={"content":tool_result,"role":"tool","tool_call_id":tool_id}messages.append(tool_message)completion=get_ai_response(messages)print(completion.model_dump_json())print(f"最终的结果是:{completion.choices[0].message.content}")

成功运行后返回code:200与真实学历数据（姓名 / 院校 / 专业 / 层次等），问题彻底解决。

---

五、避坑清单（建议收藏）

1. Pydantic Settings 不注入os.environ：别用os.getenv读.env里的密钥，统一用settings.xxx；且env_file是相对 cwd 的，跨目录运行要手动chdir。
2. 百炼非流式调用必须extra_body={"enable_thinking": False}，否则qwen-plus/qwen3直接 400。
3. 工作空间端点要对应 Key 所属空间：Key 属于ws-xxx，base_url也要用同一个空间端点，否则 403。
4. apimy.cn 类平台「每接口一密钥」：学历查询要单独申请接口专属 key，通用控制台 key 不一定能用。
5. 第三方接口 key 放 URL 查询参数、业务参数放表单体，别用 JSON body。
6. Redis 缓存库一定要核对：脚本里Redis()不指定 db 默认是db=0，而项目主配置可能是db=8，清缓存清错库等于白清。
7. 进程环境变量会覆盖.env：调试时写入系统变量的旧 key 会优先于.env.dev，必要时os.environ.pop清掉。
8. 改.env不会触发uvicorn --reload，改配置后记得重启服务。
9. 敏感信息脱敏：发布到公开平台（如本文）时，Key 打码、验证码删字符，避免凭证泄露。

---

六、小结

这一连串 403 看起来像是「密钥不对」，实际背后是配置加载、请求格式、缓存库、环境变量优先级四层问题叠加。最容易被忽略的是Redis 默认库 db=0 的缓存——用错误 key 跑一次把 403 缓存住，之后怎么改 key 都还是 403，因为根本没重新请求接口。

排查第三方接口 403，建议按这个顺序确认：

1. 请求格式对不对（key 放哪、参数放哪）；
2. key 是不是该接口专属、有没有填错/多空格；
3. 配置有没有真正加载（cwd、环境变量优先级）；
4. 有没有命中旧缓存（核对 Redis 库）。