更新Alexa for Apps技能清单时出现DENIED_FEATURE_ACCESS错误的原因

核心问题 #

执行ask smapi update-skill-manifest -s SKILLID -g development --manifest "file:skill.json" --debug命令时返回400错误，提示无"AppLink V2"功能访问权限，无法在技能清单的$.manifest.apis.custom.interfaces[0].type字段使用APP_LINKS_V2值。

排查与解决步骤 #

1. 确认AppLink V2功能是否已在技能中启用 #

• 登录Alexa开发者控制台，定位到目标技能
• 进入Build标签页，找到Alexa for Apps或App Links相关设置板块，手动确认是否已开启AppLink V2功能。该功能并非默认启用，需在控制台完成配置后才能通过SMAPI调用。

2. 修正IAM权限配置 #

• 避免使用AWS根用户操作：Alexa部分SMAPI接口限制根用户直接调用，建议创建专用IAM用户，并关联AlexaSkillsKitFullAccess托管策略
• 若使用自定义策略，确保包含SMAPI相关操作权限：

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "alexa::skills::updateSkillManifest",
                  "alexa::skills::getSkillManifest"
              ],
              "Resource": "arn:aws:alexa:region:account-id:skill/your-skill-id"
          }
      ]
  }
  

• 检查ASK CLI配置：执行ask configure确认当前登录的IAM账户为拥有正确权限的账户，避免多账户配置混淆。

3. 验证技能清单格式合规性 #

• 检查APP_LINKS_V2接口的结构是否符合SMAPI规范，示例正确结构如下：

  "apis": {
      "custom": {
          "interfaces": [
              {
                  "type": "APP_LINKS_V2",
                  "appLinks": {
                      "android": [
                          {
                              "packageName": "com.your.app.package",
                              "deepLink": "your-deep-link-scheme://target-path"
                          }
                      ]
                  }
              }
          ]
      }
  }
  

• 确认字段拼写无误，APP_LINKS_V2大小写严格匹配，接口层级正确嵌套在apis.custom下。

4. 确认技能与Android应用的关联状态 #

• 在Alexa开发者控制台的Distribution或Alexa for Apps设置中，确认已完成Android应用包名的关联绑定，且深度链接已通过控制台的验证流程（本地验证通过不代表控制台关联完成）。

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