Angular 19部署后通配路由未跳转，返回404问题求助

你的问题核心是本地开发服务器自动适配SPA路由，但生产服务器没配置路由重写，导致直接访问不存在的路径时，服务器找不到对应文件就返回404，根本没走到Angular的路由逻辑。

根本原因 #

本地ng serve内置的开发服务器已经做了配置：所有请求都会转发到index.html，Angular路由模块就能接管处理**通配符规则。但生产服务器（Nginx/Apache/IIS等）默认会把每个URL当成物理文件/目录去查找，找不到就返回404，不会转发到index.html。

解决方案：配置服务器路由重写 #

根据你使用的服务器类型，添加对应的重写规则，让所有不存在的路径都转发到index.html：

1. Nginx #

修改站点配置文件（比如/etc/nginx/sites-available/your-site.conf），在location /块中添加try_files指令：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/your/angular/dist/folder;
    index index.html;

    location / {
        # 先找实际存在的文件/目录，找不到就转发到index.html
        try_files $uri $uri/ /index.html;
    }

    # 可选：加速静态资源访问，避免不必要的转发
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

修改后重启Nginx：sudo systemctl restart nginx

2. Apache #

在Angular项目的dist目录下创建.htaccess文件，添加以下规则：

RewriteEngine On
RewriteBase /
# 不重写index.html本身
RewriteRule ^index\.html$ - [L]
# 如果请求的不是文件也不是目录，重写到index.html
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.html [L]

确保Apache启用了mod_rewrite模块，并且站点允许使用.htaccess（在Apache配置中设置AllowOverride All）。

3. IIS #

在dist目录下创建web.config文件，添加重写规则：

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Angular Routes" 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>

确保IIS启用了URL重写模块。

验证 #

配置完成后，重启服务器，访问不存在的路由（比如your-domain.com/abcdef），服务器会转发到index.html，Angular路由模块就能触发**规则跳转到/user了。

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