Azure Static Web Apps构建纯HTML项目失败：无法检测仓库语言

方案1：修改流水线任务参数，跳过构建并指定静态目录 #

针对纯静态文件项目，直接在Azure DevOps流水线的AzureStaticWebApp任务中明确配置参数，禁用自动构建检测：

- task: AzureStaticWebApp@0
  inputs:
    app_location: '.' # 静态文件所在的根目录
    output_location: '' # 无构建输出，留空即可
    skip_app_build: true # 强制跳过应用构建步骤
    azure_static_web_apps_api_token: $(AZURE_STATIC_WEB_APPS_API_TOKEN)

自动生成的流水线默认会触发Oryx的语言检测逻辑，开启skip_app_build后会直接跳过构建环节，直接部署指定目录下的静态文件。

方案2：修正Azure门户的构建配置 #

1. 登录Azure门户，找到目标Static Web App实例
2. 进入配置 -> 构建与部署页面
3. 将应用位置设为.，输出位置设为空（或.）
4. 保留ENABLE_ORYX_BUILD=false的应用配置（如果之前已设置），彻底禁用Oryx的自动构建检测

方案3：添加Static Web Apps专属配置文件 #

在项目根目录创建staticwebapp.config.json文件，明确标识这是静态站点：

{
  "routes": [
    {
      "route": "/*",
      "serve": "/index.html",
      "statusCode": 200
    }
  ]
}

该文件会引导Azure平台识别站点类型，避免触发不必要的语言检测流程。

方案4：清理冗余文件并确认目录结构 #

• 删除之前添加的dummy package.json，避免平台误判为Node.js项目
• 确保index.html、my.js、my.css直接放在项目根目录，不要嵌套在子文件夹中

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