Angular Universal SSR改造后页面无限加载无报错问题排查

一、优先排查浏览器专属依赖挂起问题 #

你怀疑的AgmCoreModule、Leaflet相关依赖是最高概率根因。这类依赖强依赖浏览器原生BOM/DOM API，即便引入domino做模拟，也会存在大量API缺失，导致宏任务/微任务挂起、Zone.js无法感知任务完成，最终SSR引擎一直等待渲染结束、不返回响应。
对应处理方式：

• 所有强依赖浏览器环境的模块（包括AgmCoreModule、Leaflet相关封装、其他直接操作window/document的第三方组件），仅在浏览器端导入，绝对不能加入AppServerModule的imports数组。可以在AppModule中通过isPlatformServer/isPlatformBrowser判断运行平台，服务端环境下跳过这类模块的导入；也可以在浏览器端运行时通过动态import()加载地图相关逻辑。
• 注意：你添加的*appShellNoRender指令仅控制模板内容是否渲染，不会阻止模块在服务端的加载执行——如果对应模块在导入阶段就执行了浏览器环境检测、注册定时器/全局事件监听，哪怕模板不渲染对应内容，依然会挂起整个渲染流程。
• index.html中直接引入的Leaflet CDN资源，建议移除。改为在地图组件初始化逻辑中判断平台，仅在浏览器环境下动态创建script/link标签加载资源，等资源加载完成后再初始化地图实例，避免服务端环境下访问未定义的L全局变量触发异常。
• domino只能模拟最基础的DOM API，Leaflet、AGM地图这类组件会调用大量domino未实现的属性（比如navigator.geolocation、元素的getBoundingClientRect、window.requestAnimationFrame的特殊逻辑等），很容易出现隐式死循环或者被Zone吞掉的异常，不要指望靠domino模拟就能让这类组件在服务端正常运行。

二、排查未被Zone.js捕获的长驻任务 #

SSR触发渲染完成返回响应的前提是Zone.js感知到所有异步任务（网络请求、定时器、事件监听）都执行完毕，如果存在未被Zone.js包裹的长驻任务，渲染流程会一直挂起。
对应排查点：

• 全局搜索代码中所有setInterval、RxJS的interval/timer长驻定时器、全局事件绑定（scroll、resize、popstate等直接绑定到window对象的监听），这类逻辑必须加平台判断，仅在浏览器端执行。
• 检查APP_INITIALIZER阶段的appConfig.json请求：确认服务端环境下请求使用的是可正常访问的绝对路径，不会出现请求pending无响应的情况。如果请求被代理规则拦截、或者地址错误，会直接导致初始化阶段挂起。
• 先确认NgxSsrTimeoutModule是否真的生效：该模块必须导入到AppServerModule中才会对服务端渲染生效，如果导入位置错误，配置的500ms超时不会执行，自然不会强制返回渲染结果。
• 给渲染逻辑加回调日志，确认挂起点：

// 修改server.ts中的路由配置
server.get('*', (req, res) => {
  const renderStartTime = Date.now();
  res.render(indexHtml, { 
    req, 
    providers: [{ provide: APP_BASE_HREF, useValue: req.baseUrl }],
    callback: (err, html) => {
      if (err) {
        console.error('渲染报错：', err);
        res.status(500).send('Server Error');
        return;
      }
      console.log(`路径${req.path}渲染耗时：${Date.now() - renderStartTime}ms`);
      res.send(html);
    }
  });
});

如果访问页面后这个回调的日志一直不输出，就能确认是渲染流程被挂起，没有触发完成逻辑。

三、修正现有配置错误 #

• domino模拟全局对象的逻辑存在隐患：当前代码直接读取dist编译目录下的index.html传入domino.createWindow，dev:ssr模式下dist目录文件是实时编译的，很容易出现读取到空文件、未编译完成文件的情况，建议直接传入基础HTML字符串作为模拟模板，不要读取编译产物。
• 检查*appShellRender/*appShellNoRender指令的平台判断逻辑，确认没有写反判断条件，导致服务端依然初始化了所有业务组件。

四、二分法快速定位根因 #

如果以上调整后问题仍存在，用二分法缩小排查范围：

1. 先把app.component.ts中除了加载动画之外的所有模板、模块导入全部注释，仅保留加载动画组件，启动服务访问。如果能正常返回响应，说明挂起问题确实出在业务组件/第三方依赖中。
2. 逐批恢复模块导入和模板内容，每恢复一批就测试一次访问，直到找到某批内容加回去之后复现无限加载问题，就能精准定位到导致挂起的具体依赖。

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