基于Python Azure SDK的Azure Bot部署Linux环境后无法运行求助

1. 优先查看Azure App Service日志 #

直接登录Azure门户，进入你的App Service实例，打开日志流（Log Stream），或者下载应用日志文件，重点排查：

• 启动阶段是否有gunicorn报错（如worker类找不到、依赖缺失）
• 接收请求时是否有认证错误、路由匹配失败等信息
  日志是定位Linux部署问题最直接的方式，很多时候能一眼看到问题根源。

2. 修正gunicorn启动命令 #

端口配置问题 #

Azure App Service Linux会通过环境变量PORT指定服务监听端口，你之前的命令未绑定到该端口，导致请求无法路由到Bot服务。修改启动命令为：

gunicorn --bind 0.0.0.0:$PORT --worker-class aiohttp.GunicornWebWorker --timeout 600 app:app

Worker类兼容性 #

新版本aiohttp已移除aiohttp.worker.GunicornWebWorker，仅保留aiohttp.GunicornWebWorker，确保你的环境中aiohttp版本≥3.8.0，gunicorn版本≥20.1.0，避免因版本不兼容导致worker初始化失败。

3. 验证依赖包一致性 #

Windows与Linux环境的依赖包可能存在版本或编译差异，确保requirements.txt明确指定兼容Linux的版本号，例如：

botframework-connector>=4.15.0
botframework-schema>=4.15.0
aiohttp>=3.8.0
gunicorn>=20.1.0

部署时勾选"重新安装所有依赖"选项，避免Azure缓存旧版本包引发问题。

4. 确认Bot认证配置 #

检查App Service的应用设置中，MicrosoftAppId和MicrosoftAppPassword是否与Azure Bot注册页面的信息完全一致，注意Linux环境下环境变量区分大小写，必须与代码中读取的键名匹配（通常为大写）。

5. 隔离测试基础Web服务 #

在app.py中暂时添加一个简单的测试路由，验证Web服务本身是否正常：

from aiohttp import web

async def hello(request):
    return web.Response(text="Hello World")

app = web.Application()
app.add_routes([web.get('/', hello)])

# 保留原Bot相关代码（注释掉先测试基础服务）
# from botbuilder.core import BotFrameworkAdapter, BotFrameworkAdapterSettings
# ...

用修改后的gunicorn命令启动，访问App Service的URL，若能返回"Hello World"，说明Web服务正常，问题出在Bot框架逻辑或配置；若无法访问，则聚焦排查Web服务启动问题。

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