先记住这个答案
默认情况下，NestJS 会在无法解析构造函数参数时抛出异常。给参数加上 @Optional() 后，解析失败会被捕获并注入 undefined。这适用于某些非必需的配置或服务，例如未注册日志模块时回退到控制台输出。但注意：它不会屏蔽其他错误，且注入 undefined 后必须在业务逻辑里做空值判断。
- @Optional() 只抑制未找到 Provider 的异常
- 依赖缺失时参数被置为 undefined
- 必须在使用前判空，否则运行时报错
注入机制的底层行为
当 NestJS 实例化 Provider 时，会读取构造函数参数的类型元数据，并尝试在容器中查找对应的 token。如果找不到，默认会抛出 Nest can't resolve dependencies of the Service 异常，导致应用启动失败。@Optional() 装饰器通知 Nest 把这次解析失败视为可容忍的错误，从而不抛异常，而是向参数传入 undefined。
需要注意，@Optional() 只影响“找不到与参数类型或 token 相匹配的 Provider”这一种情况。如果构造函数参数是普通值（如字符串）但没有用 @Inject 指定 token，Nest 会尝试以 String 作为 token 查找 Provider；如果找不到，带 @Optional 会返回 undefined，而不会抛错；不带 @Optional 则抛出异常。另外，@Optional() 对属性注入同样生效，但更常见的是用于构造函数参数。解析成功后，参数值就是注册的实例或值，不会有任何改变。
可选缓存服务回退到空实现
假设应用有一个 CacheService，但开发环境可能未注册。此时 ReportService 构造函数声明 @Optional() cacheService?: CacheService，在方法中使用时先判断 if (this.cacheService) { ... }，否则直接计算。这样在缺少缓存 Provider 的环境，应用能正常启动，并跳过缓存写入逻辑。
另一个常见场景是配置对象。例如 @Optional() config?: AppConfig，当没有注册自定义配置时，代码内部使用 process.env 的默认值。但必须确保 config 为 undefined 时不访问 config.xxx，因此在构造函数里立即做本地化处理，保存好默认值，后续方法就不会再碰 undefined。
容易踩的边界条件
@Optional() 不能区分“依赖不存在”和“依赖显式注册为 undefined”。如果 Provider 的值是 useValue: undefined，装饰器同样返回 undefined，代码无法判断是缺失还是显式 undefined。因此不要用 undefined 作为实际依赖值，若要表示“空”，应使用 null 或专门的类型。
另一个边界是循环依赖。@Optional 不能解决循环依赖。如果存在 A 依赖 B、B 依赖 A 的循环，即使其中某个依赖标记为 @Optional，Nest 在解析时仍会检测到循环并抛出异常（如 circular dependency 错误），因为 @Optional 只抑制“找不到 Provider”的异常，并不影响依赖图的构建。循环依赖应始终使用 forwardRef() 来解决。
容易答错的地方
- @Optional 提供默认实现
- 错误认识：认为 @Optional 会注入一个空对象或默认实现。实际它只返回 undefined，任何默认逻辑都需要自己在构造函数或属性访问时处理。
- 只加 @Optional 不判空
- 有些开发者加上 @Optional 后就认为安全，直接调用依赖方法，结果运行时出现
Cannot read property of undefined。必须在使用前显式检查 null/undefined。
面试官还会怎么问？
@Optional 能用在类级 Provider 上吗？
不行，@Optional 是参数装饰器，只能修饰构造函数参数或属性。对于类的自定义 Provider，需要用 @Inject() 配合 token。
如果依赖在其他模块中声明，本模块未导入，@Optional 会怎样？
只要 Nest 无法从当前模块上下文解析该 token，@Optional 就会抑制错误并返回 undefined。它不关心依赖是否在其他模块可用，只检查当前注入上下文。
如何区分依赖缺失和依赖为 null？
用 === undefined 与 === null 分别判断。但建议注册可选依赖时不要用 null，而是用 useValue: null 并在注入点显式检查，因为 @Optional 对 null 不生效。
参考资料
示例用于理解所注明的运行环境与边界；延伸学习可结合原文中的更多案例。