Angular部署AWS S3执行ng build报错：No NgModule metadata found for 'AppModule'

遇到这种本地正常、服务器端构建失败的问题确实挺闹心的，我结合你的情况整理了几个针对性的排查方向和解决方案：

1. 优先排查文件名大小写问题 #

Linux服务器是大小写敏感的，而本地Windows/macOS通常不敏感。你可以检查服务器上的app.module.ts文件名是否完全匹配代码中的引用——比如有没有写成App.Module.ts或者app.module.TS？Angular的模块解析在大小写敏感环境下会找不到正确文件，直接导致元数据读取失败。

2. 对比本地与服务器的构建命令参数 #

确认你在服务器上执行的构建命令和本地是否一致：

• 本地是不是直接用ng build，而服务器加了--prod或者其他环境参数？
• 可以先在服务器上尝试执行ng build --prod=false，看是否能正常构建，排除生产环境优化策略导致的问题。

3. 检查Angular配置文件的入口路径 #

根据你的Angular版本，检查.angular-cli.json（旧版本）或angular.json（新版本）中的main字段，确认它指向的src/main.ts路径正确，且main.ts中确实正确导入并启动了AppModule：

// main.ts 应该包含这段代码
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { AppModule } from './app/app.module';

platformBrowserDynamic().bootstrapModule(AppModule);

4. 彻底清理服务器端的构建缓存 #

除了删除node_modules，还要做这些操作：

• 删除项目根目录下的dist文件夹
• 执行ng clean（Angular CLI 6+支持）清理CLI缓存
• 或者手动删除服务器用户目录下的~/.angular缓存文件夹
  之后重新执行npm install和ng build。

5. 检查服务器文件权限 #

确认服务器上的项目目录（包括src、node_modules）有足够的读写权限，避免编译器无法读取app.module.ts内容。可以执行以下命令修复权限：

chmod -R 755 /srv/www/salesboomerang.com/adminpanel

附你的报错信息： #

ERROR in Error: No NgModule metadata found for 'AppModule'. 
at NgModuleResolver.resolve (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler/bundles/compiler.umd.js:20247:23) 
at CompileMetadataResolver.getNgModuleMetadata (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler/bundles/compiler.umd.js:15216:60) 
at visitLazyRoute (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler/bundles/compiler.umd.js:31061:104) 
at AotCompiler.listLazyRoutes (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler/bundles/compiler.umd.js:31029:20) 
at AngularCompilerProgram.listLazyRoutes (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler-cli/src/transformers/program.js:156:30) 
at Function.NgTools_InternalApi_NG_2.listLazyRoutes (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/compiler-cli/src/ngtools_api.js:44:36) 
at AngularCompilerPlugin._getLazyRoutesFromNgtools (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/cli/node_modules/@ngtools/webpack/src/angular_compiler_plugin.js:249:66) 
at Promise.resolve.then.then (/srv/www/salesboomerang.com/adminpanel/node_modules/@angular/cli/node_modules/@ngtools/webpack/src/angular_compiler_plugin.js:572:50) 
at <anonymous>

你的app.module.ts代码： #

import { BrowserModule } from '@angular/platform-browser'; 
import { BrowserAnimationsModule } from '@angular/platform-browser/animations'; 
import { NgModule } from '@angular/core'; 
import { HttpClientModule, HttpClient } from '@angular/common/http'; 
import { AppComponent } from './app.component'; 
import { CoreModule } from './core/core.module'; 
import { LayoutModule } from './layout/layout.module'; 
import { SharedModule } from './shared/shared.module'; 
import { RoutesModule } from './routes/routes.module'; 
import 'hammerjs'; 
import { HttpModule } from '@angular/http'; 

@NgModule({ 
  declarations: [ 
    AppComponent, 
  ], 
  imports: [ 
    BrowserModule, 
    BrowserAnimationsModule, 
    CoreModule, 
    LayoutModule, 
    SharedModule.forRoot(), 
    RoutesModule, 
    HttpClientModule, 
    HttpModule 
  ], 
  providers: [], 
  bootstrap: [AppComponent] 
}) 
export class AppModule { }

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