本地运行Azure OpenAI+Cognitive Search聊天机器人Demo遇InternalServerError

• 检查本地网络代理
  本地代理（VPN、代理客户端）可能拦截请求，导致无法正常连接Azure服务：

  • 关闭代理工具后重试；
  • 若需保留代理，将*.openai.azure.com、*.search.azure.com加入代理白名单。

• 验证环境变量加载
  即使.env参数正确，本地开发服务器可能未完全加载配置：

  • 重启本地服务，确保.env修改生效；
  • 在代码中打印AZURE_OPENAI_API_KEY、AZURE_OPENAI_ENDPOINT等关键变量，确认实际读取值与配置一致。

• 同步本地系统时间
  Azure服务对请求时间戳有校验，本地时间与UTC偏差过大可能触发验证失败：

  • 将本地系统时间同步至网络时间服务器，控制误差在5分钟内。

• 直接测试API连通性
  用curl或Postman绕开代码直接请求Azure OpenAI接口，定位问题环节：

  curl -X POST https://{你的OpenAI资源名}.openai.azure.com/openai/deployments/{你的部署名}/chat/completions?api-version=2023-03-15-preview \
  -H "Content-Type: application/json" \
  -H "api-key: {你的API密钥}" \
  -d '{"messages": [{"role": "user", "content": "Hello"}]}'
  

  若直接请求仍报错，排查网络或账号权限；若成功，检查代码中请求构造逻辑。

• 检查资源IP访问限制
  Azure OpenAI/Cognitive Search可能设置了IP防火墙规则：

  • 登录Azure门户，查看对应资源的网络配置，确认本地公网IP已在允许列表内；
  • 临时关闭IP防火墙（仅测试），验证是否能正常调用。

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