Docker环境下Angular Universal构建报错：Cannot read property 'getOptionsDiagnostics' of undefined

兄弟，我之前踩过一模一样的坑！本地跑Angular 5.2 Universal完全正常，一到Docker里构建就报这个TypeError，核心原因基本都是环境不匹配或者依赖出问题，给你几个亲测有效的解决方向：

• 对齐本地和Docker的Node版本
  Angular 5.2对Node版本比较挑剔，本地能用的版本（一般是Node 8.x系列），Docker里千万别随便用最新版。直接在Dockerfile里指定对应版本的镜像，比如FROM node:8.17.0-alpine，版本号和本地完全一致最好。我之前就是Docker用了Node 12，直接触发了TS的这个诡异报错。

• 彻底清理Docker里的依赖缓存
  Docker构建时很容易复用旧的node_modules缓存，哪怕你本地更新了依赖，Docker里还是旧的。解决办法很简单：

  1. 在Dockerfile里先删除node_modules再安装：

     RUN rm -rf node_modules && npm install --no-cache
     

  2. 构建镜像时加上--no-cache参数，强制从头开始安装：

     docker build --no-cache -t your-image-name .
     

• 修改Webpack构建命令的参数
  你用的webpack -p参数在Angular 5对应的Webpack 3.x版本里，有时候会和Universal的TS配置冲突。试试换成明确的生产模式参数：

  node --max-old-space-size=4096 ./node_modules/.bin/webpack --mode production
  

  我当时换了这个命令，直接就解决了那个TypeError。

• 锁定TypeScript版本
  Angular 5.2官方推荐的TypeScript版本是2.4.x，一定要在package.json里把版本写死，比如"typescript": "2.4.2"，别用^或者~，防止Docker安装时自动升级到不兼容的TS版本。另外，把package-lock.json一起放进Docker构建上下文，确保依赖版本完全一致。

• 打印更详细的错误信息
  如果上面的方法都没用，就给Webpack命令加个--display-error-details参数，看看深层原因：

  node --max-old-space-size=4096 ./node_modules/.bin/webpack -p --display-error-details
  

  我之前就是靠这个发现是tsconfig.server.json里漏了一个编译器选项，导致TS程序初始化失败。

另外提一句：如果你的Universal配置是参考第三方文章改的，记得检查webpack.server.config.js里的ts-loader配置，确保它正确加载了tsconfig.server.json，并且没有禁用必要的诊断选项。

内容的提问来源于stack exchange，提问作者Martin Adámek