Nuxt中pages自动生成路由失效，Azure部署后仅根路由可用，需手动配置吗？

首先明确：手动配置prerender路由不是必须的，你遇到的问题核心是Azure Web App的服务器配置，而非Nuxt的路由自动生成逻辑。

为什么本地正常，部署后只有根路由可用？ #

本地开发时，Nuxt的开发服务器会自动处理所有路由请求，将非文件/目录的请求转发到index.html，让客户端路由（Vue Router）接管跳转。但Azure Web App默认按静态文件托管逻辑处理：当你访问/about这类子路由时，服务器会尝试找/about.html或/about/index.html，找不到就返回404，不会自动回退到根目录的index.html。

正确的解决方法：配置Azure Web App回退规则 #

在项目根目录创建web.config文件（Azure Web App基于IIS，需要这个配置文件），内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="SPA Fallback" stopProcessing="true">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="/index.html" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

执行nuxt generate后，这个文件会被包含在生成的dist（或.output/public，取决于Nuxt版本）文件夹中，部署到Azure时一起上传即可。之后所有非文件/目录的请求都会被转发到index.html，客户端路由就能正常工作了。

什么时候需要手动配置prerender路由？ #

你看到的那种手动添加路由到prerender配置的场景，是当你需要预渲染静态HTML文件时（比如需要SEO优化，让搜索引擎能抓取到子路由的内容）。这种情况下，Nuxt会为每个指定的路由生成对应的静态HTML文件，此时访问子路由时服务器会直接返回对应的HTML，而非依赖客户端路由跳转。但如果只是普通SPA需求，不需要预渲染，就完全不需要做这个配置。

额外确认Nuxt配置 #

确保你的nuxt.config.ts中开启了SPA模式：

// Nuxt 3 配置示例
export default defineNuxtConfig({
  ssr: false, // 禁用服务端渲染，纯SPA模式
})

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