本地VSCode运行Python Azure Function时Listener启动失败求助

1. 检查本地网络与端点连通性 #

• 用telnet <IoT-Hub-Endpoint-Hostname> 5671（Linux/macOS）或Test-NetConnection <IoT-Hub-Endpoint-Hostname> -Port 5671（Windows PowerShell）测试AMQP端口连通性，确认本地能访问IoT Hub的5671端口。如果不通，排查防火墙、公司网络是否拦截了该端口，或切换到手机热点等其他网络环境测试。

2. 验证连接字符串正确性 #

• 确认本地调试用的IoT Hub内置Event Hub兼容端点连接字符串是否正确，重点检查EntityPath是否为messages/events、SharedAccessKey是否有效（可在Azure门户重新生成密钥后测试）。
• 检查local.settings.json中的配置项，比如AzureWebJobsStorage、IoT Hub相关连接字符串的键名是否拼写正确，有没有多余空格或格式错误。

3. 排查依赖包兼容性 #

• 查看requirements.txt中azure-functions、azure-eventhub、azure-eventhub-checkpointstore-blob等依赖的版本，近期包更新可能引发兼容性问题。可尝试回退到之前稳定运行的版本，例如：

  azure-functions==1.17.0
  azure-eventhub==5.11.1
  azure-eventhub-checkpointstore-blob==1.16.0
  

• 执行pip uninstall -r requirements.txt -y && pip install -r requirements.txt彻底重装依赖，清理缓存。

4. 检查Azure Function Core Tools版本 #

• 终端运行func --version查看版本，若近期自动更新了新版本，可能存在兼容性问题。尝试回退到之前正常运行的稳定版本（比如v4.x的旧版），再重新调试。

5. 确认IoT Hub状态与配额 #

• 登录Azure门户查看IoT Hub的运行状态，检查“指标”中的入站消息、连接数等数据，确认是否存在限流、配额超标情况。
• 确认IoT Hub定价层是否满足当前需求，排除因资源调整导致的隐性限制。

6. 代理环境排查 #

• 若本地使用代理，确认VSCode和终端的代理配置是否正确。可临时在终端取消代理后测试：

  unset HTTP_PROXY
  unset HTTPS_PROXY
  

  再运行func start启动函数。

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