使用Angular Universal SSR的Angular应用在Google Search Console中出现Soft 404错误

一、剩余动态页面的具体修复步骤 #

• 精准校验动态路由参数有效性
  要在服务端（比如server.ts或者对应的路由守卫/解析器中），针对动态路由参数（比如产品ID t-shirt-20），直接调用后端API校验资源是否存在。得在SSR渲染前完成校验，别等到客户端渲染后才判断。
  示例代码（路由解析器中加入校验逻辑）：

  @Injectable()
  export class ProductResolver implements Resolve<Product> {
    constructor(private productService: ProductService, private http: HttpClient) {}
  
    resolve(route: ActivatedRouteSnapshot): Observable<Product> {
      const productId = route.paramMap.get('id');
      return this.productService.getProduct(productId).pipe(
        catchError(() => {
          // 服务端直接抛出404
          if (typeof window === 'undefined') {
            const res = require('express').response;
            res.status(404);
          }
          throw new Error('Product not found');
        })
      );
    }
  }
  

  一定要确保校验逻辑在服务端执行时能正确修改响应状态码，Angular Universal的server.ts里可以通过res.status()直接设置。

• 统一服务端错误处理流程
  在server.ts中加全局错误拦截，当路由解析失败或者资源不存在时，强制返回404状态码，同时渲染自定义的404页面，别返回200状态却显示错误内容。
  示例（server.ts渲染逻辑中加入判断）：

  server.get('*', (req, res) => {
    res.render(indexHtml, {
      req,
      providers: [
        { provide: APP_BASE_HREF, useValue: req.baseUrl },
        { provide: REQUEST, useValue: req },
        { provide: RESPONSE, useValue: res }
      ]
    }, (err, html) => {
      if (err) {
        if (err.message.includes('Product not found')) {
          res.status(404).send(render404Page()); // 自定义渲染404页面的函数
        } else {
          res.status(500).send(err.toString());
        }
      } else {
        res.send(html);
      }
    });
  });
  

• 排查路由匹配优先级问题
  检查动态路由的定义顺序，确保更具体的路由（比如/products/:id）不会被更宽泛的路由（比如/**）提前匹配，不然会导致错误的页面渲染和状态码返回。记得把动态路由放在通配符路由前面。

• 验证Googlebot抓取的实际响应
  用Google Search Console的「URL检查工具」输入有问题的页面URL，查看实际的HTTP状态码和返回内容。如果状态码是200但内容是错误页，那就是Soft 404的根源，得调整服务端逻辑确保返回404。也可以用curl -I https://your-domain/products/t-shirt-20命令，直接查看响应头的状态码，确认服务端是否正确返回404。

二、避免Soft 404错误的最佳实践 #

• 始终在服务端校验资源存在性：别依赖客户端的路由守卫或数据校验，Googlebot主要看服务端返回的响应状态和内容，客户端逻辑不会影响索引判断。
• 统一错误页面的状态码：所有不存在的资源，不管是静态还是动态页面，都要返回404状态码，并且渲染一致的404页面，别返回200状态却显示错误内容。
• 使用结构化数据标记错误页：在404页面中添加<meta name="robots" content="noindex">，或者用Schema.org的ErrorPage结构化数据，明确告诉搜索引擎这是错误页面，避免被误判为有效内容。

  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "ErrorPage",
    "name": "Page Not Found"
  }
  </script>
  

• 定期监控Search Console：设置Soft 404错误的提醒，及时发现新问题，尤其是上线新动态路由或修改产品数据后。
• 避免返回空白或无意义内容：如果动态页面的资源不存在，别返回空白页或默认模板页，必须返回明确的404页面和状态码，不然Google会认为这是有效但低质量的内容，导致Soft 404。
• 测试SSR渲染的完整流程：每次修改路由或服务端逻辑后，用SSR模式启动应用，测试动态路由的响应状态，确保服务端渲染时就能正确返回对应的状态码。

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