AWS Elastic Beanstalk环境健康Severe级报错排查咨询

核心结论 #

该报错属于ORM层实体加载失败问题，完全不需要更换绑定新target group与security id的load balancer。负载均衡、安全组属于网络层配置，仅影响流量转发、访问连通性，不会触发应用层ORM框架的实体注册错误，也不属于AWS平台层面故障。

已验证无效的方案 #

• 单独修改EBS中实体路径的环境配置
• 直接设置autoloadEntities: true

针对性排查步骤（适配Node.js 12运行时） #

本地运行正常、EBS部署触发该错误，全部是部署包内容、路径匹配、配置读取的差异导致，按优先级排查：

1. 排查部署包文件过滤规则
   检查项目根目录的.ebignore、.npmignore文件，确认没有误排除实体类所在目录、TypeScript编译输出目录。EBS部署时会按照这两个文件的规则过滤上传内容，一旦实体文件被排除，运行时自然找不到对应类。
   额外注意：EBS运行环境是Amazon Linux，文件路径大小写敏感，本地Windows/macOS默认大小写不敏感，路径、文件名大小写不匹配的问题本地不会触发，部署后100%报错。可以直接登录EBS实例进入当前部署版本的项目目录，核对实体文件的实际路径和代码中配置的路径是否完全一致。
2. 替换实体加载方式
   Node.js 12环境下，TypeORM的路径扫描+自动加载逻辑在EBS上会因为工作目录差异、glob匹配权限问题失效，不要依赖路径扫描加载实体，直接显式引入所有实体类注册到ORM配置中：

   // 弃用路径扫描写法
   // entities: ["dist/entities/**/*.js"]
   
   // 替换为显式引入
   const { OauthApplication } = require("./entities/OauthApplication");
   module.exports = {
     // 其余数据库配置保持不变
     entities: [OauthApplication],
     autoloadEntities: false
   }
   

3. 核对环境变量加载逻辑
   检查EBS控制台配置的环境变量，重点确认NODE_ENV值和本地运行时的取值一致。大部分项目的ORM配置会根据NODE_ENV加载不同的配置块，若EBS上NODE_ENV为production，而生产配置块中没有注册对应实体，就会触发该报错。

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