Azure应用服务部署Vue应用后无法加载及GitHub Actions部署异常求助

部署后始终显示Azure默认落地页的解决步骤 #

• 核对部署文件路径与站点根目录的匹配性
  Azure Linux应用服务对外暴露的静态文件根目录为/home/site/wwwroot，需确保打包生成的dist目录内的所有文件（不是dist目录本身）被直接部署到该路径下。很多人部署时直接把整个项目根目录推上去，若该目录下没有直接放置index.html、静态资源文件夹，而是套了一层项目结构或者嵌套了dist文件夹，站点会自动回退显示Azure默认落地页。
  可直接通过应用服务的Kudu高级工具进入文件系统，检查/home/site/wwwroot下的文件结构，确认入口文件存在。
• 核对应用服务运行栈与启动命令配置
  若创建应用服务时选择了带Node运行时的动态站点栈，Azure会通过预设的启动命令优先启动自带的默认欢迎页进程，哪怕wwwroot目录下放了你的Vue静态文件，也会因为启动命令优先级更高，无法正常展示页面。需进入应用服务「配置-常规设置」，将运行栈切换为自定义（Custom）模式，清除默认的欢迎页启动命令，确保静态托管能力生效。
• 排除缓存影响
  部署完成后通过硬刷新（Ctrl+Shift+R）清除浏览器缓存，也可直接通过Kudu文件系统访问index.html路径，确认是否为缓存残留显示旧的默认页。

对接REST API的配置注意事项 #

• 跨域配置：避免在前端代码中硬编码跨域规则，优先通过同域相对路径调用接口，统一在Azure应用服务的CORS配置项中添加允许的API来源地址，减少本地与生产环境的路径差异问题。
• 敏感配置管理：生产环境的API地址、密钥类信息不要硬编码在前端代码中，统一存储在Azure应用服务的「应用设置」项中，这类配置不会被打包进前端静态文件，可避免敏感信息泄露。
• 路由适配：若Vue项目使用history路由模式，需配置URL重写规则，将所有非静态资源的请求重定向到index.html，避免页面刷新时出现404。

Upload artifact步骤触发ECONNRESET报错的原因与解决 #

该报错属于GitHub Actions服务侧的网络连接问题，和Azure配置、项目代码无关联：

• 当前配置中path: .会把整个项目目录（包括node_modules、.git、所有未通过.gitignore排除的文件）作为上传对象，文件体量过大，上传过程中极易和GitHub的artifact存储服务出现连接中断，触发ECONNRESET报错。
• 若构建与部署动作在同一个Workflow Job内完成，完全不需要配置upload-artifact步骤，构建完成后直接调用Azure部署动作推送产物即可，移除该步骤不会影响部署效果。
• 若确实需要跨Job传递构建产物，需将上传路径修改为仅上传打包生成的dist目录内容，同时将actions/upload-artifact的版本从v2升级到v4——v2版本存在大量连接不稳定的已知问题，升级后可大幅降低这类网络报错的概率。

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