本地运行Azure Cognitive Search示例应用遇环境配置不完整错误

1. 补全必要的本地环境变量 #

本地启动时，start.ps1可能未自动同步所有Azure资源配置，需手动设置以下核心环境变量（值可从Azure Portal对应资源的概述页面获取）：

• AZURE_SEARCH_SERVICE_ENDPOINT：Azure认知搜索服务端点
• AZURE_SEARCH_INDEX_NAME：部署时创建的搜索索引名（默认值为gptkbindex）
• AZURE_OPENAI_ENDPOINT：OpenAI服务端点
• AZURE_OPENAI_GPT_DEPLOYMENT：GPT模型部署名称
• AZURE_OPENAI_EMBEDDING_DEPLOYMENT：嵌入模型部署名称

PowerShell中临时设置示例：

$env:AZURE_SEARCH_SERVICE_ENDPOINT = "https://[你的搜索服务名].search.windows.net"
$env:AZURE_SEARCH_INDEX_NAME = "gptkbindex"
$env:AZURE_OPENAI_ENDPOINT = "https://[你的OpenAI服务名].openai.azure.com/"
$env:AZURE_OPENAI_GPT_DEPLOYMENT = "gpt-35-turbo"
$env:AZURE_OPENAI_EMBEDDING_DEPLOYMENT = "text-embedding-ada-002"

2. 验证Azure CLI登录权限 #

尽管日志显示AzureCliCredential获取了令牌，仍需确认当前登录账号拥有对应资源的访问权限：

1. 执行命令检查当前登录租户：

az account show

确保输出的tenantId与AZURE_TENANT_ID一致。
2. 在Azure Portal中确认该账号已被分配认知搜索参与者、认知服务参与者等角色权限。

3. 修复前端UI配置 #

空白页面大概率是前端未正确获取配置，进入app/frontend目录：

• 检查是否存在.env文件，若不存在则手动创建
• 在.env中填入必要配置：

REACT_APP_API_BASE_URL=http://localhost:5000
REACT_APP_AZURE_TENANT_ID=[你的租户ID]

保存后重启前端服务。

4. 排查后端服务错误 #

直接启动后端服务查看详细错误日志，定位具体配置问题：

cd app/api
pip install -r requirements.txt
$env:FLASK_ENV="development"
flask run

观察控制台输出，重点关注是否有连接Azure搜索/OpenAI服务失败、参数缺失等报错信息。

5. 调整start.ps1脚本逻辑 #

若脚本未自动拉取配置，可临时修改脚本：

• 在脚本开头添加从Azure资源中读取配置的逻辑，或直接临时写入正确的环境变量值（仅本地测试使用，不要提交到代码仓库）
• 检查脚本是否遗漏了AZURE_OPENAI_API_KEY等变量设置（若未启用托管标识，需手动设置API密钥）

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