GitHub部署静态HTML到Azure Static Web App报wwwroot不存在错误
故障根因
部署触发的报错信息如下:
The app build failed to produce artifact folder: 'wwwroot'. Please ensure this property is configured correctly in your workflow file.
报错核心原因是你对output_location参数的理解存在偏差:
该参数指代的是构建流程结束后,最终待部署静态产物所在的目录,路径是相对于app_location配置的相对路径,并非Azure托管环境会自动创建的目录。
你的站点是纯静态HTML站点,不存在编译、打包类的构建步骤,所有待部署文件直接存放在/Website目录根下,工作流执行时会按照你配置的wwwroot去/Website/wwwroot路径下查找待部署文件,该路径实际不存在,因此抛出上述错误。
你当前配置里的app_location: "/Website"是正确的,不需要修改。
修复方案
直接修改GitHub仓库中Azure Static Web Apps工作流文件的output_location参数即可:
- 无构建步骤的纯静态站点场景,将
output_location的值设置为空字符串"",代表直接将app_location指向目录下的所有文件作为部署产物,不需要额外查找构建输出子目录 - 如果你后续引入前端构建工具(比如Webpack、Vite等),且构建工具确实会在
/Website目录下生成对应子目录存放最终打包产物,再将该参数值调整为对应构建输出目录名即可
修改后对应配置段如下:
app_location: "/Website" # App source code path api_location: "" # Api source code path - optional output_location: "" # Built app content directory - optional
验证方式
将修改后的工作流文件提交并推送到main分支,会自动触发新一轮CI/CD部署流程,本次执行不会再出现找不到产物文件夹的报错,部署完成后即可通过Azure Static Web App分配的默认域名访问站点。
内容的提问来源于stack exchange,提问作者Sandeep Thomas
相关产品推荐
相关产品推荐

