咨询：子组件ngOnInit()未触发的潜在原因及排查方案

一、核心排查步骤 #

• 确认组件是否实际渲染：在子组件模板中添加静态文本（比如<p>子组件已加载</p>），或通过浏览器开发者工具查看DOM树，确认组件元素是否存在。如果未渲染，可能是父组件中*ngIf/*ngFor条件不满足、路由配置错误，或父组件未正确使用子组件的选择器。
• 二次校验NgModule配置：
  • 子组件必须在所属模块的declarations数组中，且不能同时在多个模块声明（共享组件需放在共享模块，通过exports导出后供其他模块导入）。
  • 若使用懒加载模块，确保组件属于该懒加载模块，或共享模块已被正确导入到懒加载模块中。
• 检查组件是否被误用为服务：如果组件被添加到模块的providers数组中，Angular会将其作为服务实例化，而非组件，此时不会触发组件生命周期钩子（服务无此钩子）。
• 排查构造函数静默错误：在子组件构造函数中添加console.log('组件构造函数执行')，确认是否执行。若构造函数中有被try-catch吞掉的错误，会导致组件初始化中断，ngOnInit无法触发。
• 验证动态创建组件的流程：如果是通过ViewContainerRef动态创建组件，需确认已调用createComponent()方法，且完成了组件的挂载操作。
• 排除OnPush变更检测的间接影响：虽然changeDetection: ChangeDetectionStrategy.OnPush不会阻止ngOnInit触发，但如果组件因变更检测未触发而未被正确初始化，可临时切换为默认策略验证。

二、ngOnInit触发机制核心要点 #

• ngOnInit是Angular组件生命周期的首个钩子，在构造函数执行后、组件输入属性（@Input）绑定完成时触发，用于完成组件初始化的后续操作（比如基于输入属性调用服务、初始化数据）。
• 触发的必要条件：组件被Angular编译器正确识别并实例化，且组件已被插入到DOM中（或动态创建的组件已完成挂载）。
• 路由加载的组件：ngOnInit在路由激活、组件挂载到DOM后触发；嵌套子组件：在父组件渲染过程中，子组件被解析并挂载时触发。
• 构造函数仅负责类的实例化与依赖注入，而ngOnInit是Angular完成组件配置后的初始化入口，二者分工明确。

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