通过CI/CD部署Teams Toolkit应用时提示无效项目错误

我开发的MS Teams聊天机器人在本地、测试工具和Azure环境中都能正常配置、部署和运行。因为其他项目都搭好了CI/CD，所以第一次给这个Node.js项目配置CI/CD。按照微软Azure DevOps管道指南操作时，执行npx teamsapp deploy命令失败，报错：

(✖) Error: coordinator.InvalidProjectError: This command only works for project created by Teams Toolkit.

我的teamsapp.yml是标准的Teams Toolkit配置，搞不懂为什么部署脚本会判定项目不是Teams Toolkit创建的。下面是我用的YAML管道代码和teamsapp.yml内容：

YAML管道代码 #

trigger:
  - dev

pool:
  vmImage: ubuntu-latest

variables:
  TEAMSAPP_CLI_VERSION: 3.0.0

steps:
  - task: NodeTool@0
    inputs:
      versionSpec: "20"
      checkLatest: true

  - script: |
      npm install @microsoft/teamsapp-cli@$(TEAMSAPP_CLI_VERSION)
    displayName: "Install CLI"

  - script: |
      npx teamsapp auth login azure --username $(AZURE_SERVICE_PRINCIPAL_CLIENT_ID) \
      --service-principal true \
      --tenant $(AZURE_TENANT_ID) \
      --password $(AZURE_SERVICE_PRINCIPAL_CLIENT_SECRET) \
      --interactive false
    displayName: "Login to Azure by service principal"

  - script: |
      npx teamsapp deploy \
      --ignore-env-file true \
      --interactive false
    displayName: "Deploy to Azure"
    workingDirectory: $(System.DefaultWorkingDirectory)

  - script: |
      npx teamsapp package
    displayName: "Package app"
    workingDirectory: $(System.DefaultWorkingDirectory)

  - publish: $(System.DefaultWorkingDirectory)/appPackage/build/appPackage.zip
    artifact: artifact

teamsapp.yml内容 #

# Triggered when 'teamsfx deploy' is executed
deploy:
  # Run npm command
  - uses: cli/runNpmCommand
    name: install dependencies
    with:
      args: install
  - uses: cli/runNpmCommand
    name: build app
    with:
      args: run build --if-present
  # Deploy your application to Azure App Service using the zip deploy feature.
  - uses: azureAppService/zipDeploy
    with:
      # Deploy base folder
      artifactFolder: .
      # Ignore file location, leave blank will ignore nothing
      ignoreFile: .webappignore
      # The resource id of the cloud resource to be deployed to.
      # This key will be generated by arm/deploy action automatically.
      # You can replace it with your existing Azure Resource id
      # or add it to your environment variable file.
      resourceId: ${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}

• 检查项目根目录必备文件：Teams Toolkit CLI会验证项目是否包含teamsapp.yml和teamsapp.local.yml（或对应环境的配置文件），确保这两个文件都在$(System.DefaultWorkingDirectory)指定的路径下，无路径错误。
• 对齐CLI版本与配置文件：你使用的是v3.0.0版本的Teamsapp CLI，但配置文件第一行注释还是旧版的teamsfx deploy，v3.x版本对配置格式有更新，建议：
  1. 将注释改为# Triggered when 'teamsapp deploy' is executed
  2. 确认配置中使用的action（如azureAppService/zipDeploy）兼容v3.x版本
• 确保环境变量配置正确：${{BOT_AZURE_APP_SERVICE_RESOURCE_ID}}需要在Azure DevOps管道变量中正确配置，或者在项目的环境文件中定义，变量缺失可能导致CLI解析配置时判定项目无效。
• 调用本地安装的CLI：用npx调用可能会优先使用全局版本，建议直接调用本地安装的CLI避免版本不一致：

  ./node_modules/.bin/teamsapp deploy --ignore-env-file true --interactive false
  

• 添加项目标识字段：Teams Toolkit创建的项目会在teamsapp.yml顶部包含projectId字段，你可以手动生成一个UUID添加进去，示例：

  projectId: "a1b2c3d4-e5f6-7890-abcd-1234567890ab"
  # Triggered when 'teamsapp deploy' is executed
  deploy:
    # 原有配置内容
  

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