Angular Universal仅显示CSS导入，无HTML内容及Meta标签问题

近期为Angular项目集成@nguniversal/express-engine，但页面查看源代码时仅能看到CSS导入，各组件（页面）中的HTML内容和Meta描述标签都无法找到。未修改@nguniversal/express-engine的初始配置，期望在页面源码中正常显示HTML内容与对应Meta标签。

以下是项目的SSR配置代码：

app.server.module.ts

import { NgModule } from '@angular/core';
import { ServerModule } from '@angular/platform-server';

import { AppModule } from './app.module';
import { AppComponent } from './app.component';

@NgModule({
  imports: [
    AppModule,
    ServerModule,
  ],
  bootstrap: [AppComponent],
})
export class AppServerModule {}

app.module.ts

@NgModule({
  declarations: [
    AppComponent,
  ],
  imports: [
    CommonModule,
    BrowserModule.withServerTransition({ appId: 'serverApp' }),
    BrowserAnimationsModule,
    AppRoutingModule,
    HttpClientModule,
    SharedModule,
  ],
  providers: [],
  bootstrap: [AppComponent],
})
export class AppModule { }

main.server.ts

/***************************************************************************************************
 * Initialize the server environment - for example, adding DOM built-in types to the global scope.
 *
 * NOTE:
 * This import must come before any imports (direct or transitive) that rely on DOM built-ins being
 * available, such as `@angular/elements`.
 */
import '@angular/platform-server/init';

import { enableProdMode } from '@angular/core';

import { environment } from './environments/environment';

if (environment.production) {
  enableProdMode();
}

export { AppServerModule } from './app/app.server.module';
export { renderModule } from '@angular/platform-server';

server.ts

import 'zone.js/node';

import { APP_BASE_HREF } from '@angular/common';
import { ngExpressEngine } from '@nguniversal/express-engine';
import * as express from 'express';
import { existsSync } from 'fs';
import { join } from 'path';

import { AppServerModule } from './src/main.server';

// The Express app is exported so that it can be used by serverless Functions.
export function app(): express.Express {
  const server = express();
  const distFolder = join(process.cwd(), 'dist/DiarAlkhibra/browser');
  const indexHtml = existsSync(join(distFolder, 'index.original.html')) ? 'index.original.html' : 'index';

  // Our Universal express-engine (found @ https://github.com/angular/universal/tree/main/modules/express-engine)
  server.engine('html', ngExpressEngine({
    bootstrap: AppServerModule,
  }));

  server.set('view engine', 'html');
  server.set('views', distFolder);

  // Example Express Rest API endpoints
  // server.get('/api/**', (req, res) => { });
  // Serve static files from /browser
  server.get('*.*', express.static(distFolder, {
    maxAge: '1y'
  }));

  // All regular routes use the Universal engine
  server.get('*', (req, res) => {
    res.render(indexHtml, { req, providers: [{ provide: APP_BASE_HREF, useValue: req.baseUrl }] });
  });

  return server;
}

function run(): void {
  const port = process.env['PORT'] || 4000;

  // Start up the Node server
  const server = app();
  server.listen(port, () => {
    console.log(`Node Express server listening on http://localhost:${port}`);
  });
}

// Webpack will replace 'require' with '__webpack_require__'
// '__non_webpack_require__' is a proxy to Node 'require'
// The below code is to ensure that the server is run only when not requiring the bundle.
declare const __non_webpack_require__: NodeRequire;
const mainModule = __non_webpack_require__.main;
const moduleFilename = mainModule && mainModule.filename || '';
if (moduleFilename === __filename || moduleFilename.includes('iisnode')) {
  run();
}

export * from './src/main.server';

排查与解决步骤 #

1. 确认路由配置支持SSR #

确保路由使用path策略，Angular SSR不支持HashLocationStrategy。检查AppRoutingModule：

import { NgModule } from '@angular/core';
import { RouterModule, Routes } from '@angular/router';
import { HomeComponent } from './home/home.component';

const routes: Routes = [
  { path: '', component: HomeComponent },
  // 其他路由配置
];

@NgModule({
  imports: [RouterModule.forRoot(routes)], // 无useHash: true
  exports: [RouterModule]
})
export class AppRoutingModule { }

2. 移除组件中的浏览器API依赖 #

SSR在Node环境执行，组件中直接使用window、document会导致渲染失败，需用PLATFORM_ID判断环境：

import { Component, OnInit, Inject, PLATFORM_ID } from '@angular/core';
import { isPlatformBrowser } from '@angular/common';

@Component({
  selector: 'app-home',
  templateUrl: './home.component.html',
  styleUrls: ['./home.component.css']
})
export class HomeComponent implements OnInit {
  constructor(@Inject(PLATFORM_ID) private platformId: Object) { }

  ngOnInit(): void {
    if (isPlatformBrowser(this.platformId)) {
      // 仅在浏览器环境执行依赖浏览器API的代码
      console.log(window.innerWidth);
    }
  }
}

3. 规范Meta标签设置方式 #

使用Angular官方Meta服务设置标签，而非直接操作DOM：

import { Component, OnInit } from '@angular/core';
import { Meta } from '@angular/platform-browser';

@Component({
  selector: 'app-home',
  templateUrl: './home.component.html',
  styleUrls: ['./home.component.css']
})
export class HomeComponent implements OnInit {
  constructor(private meta: Meta) { }

  ngOnInit(): void {
    this.meta.updateTag({ name: 'description', content: '首页描述内容' });
  }
}

4. 验证构建与启动命令 #

确保执行正确的SSR构建流程：

# 构建客户端代码
ng build --configuration production
# 构建服务端代码
ng run DiarAlkhibra:server:production
# 启动SSR服务器
node dist/DiarAlkhibra/server/main.js

替换DiarAlkhibra为你的项目名称。

5. 检查server.ts路径配置 #

确认distFolder与实际构建输出路径一致，若构建后browser目录在dist根目录，需调整：

const distFolder = join(process.cwd(), 'dist/browser');

6. 添加日志排查请求流向 #

在server.ts中添加日志，确认请求是否经过Universal引擎处理：

server.get('*', (req, res) => {
  console.log(`Processing request for: ${req.url}`);
  res.render(indexHtml, { req, providers: [{ provide: APP_BASE_HREF, useValue: req.baseUrl }] });
});

启动服务器后，访问页面查看控制台日志，若未打印说明请求未命中Universal路由。

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