logologo
文档仓库
文档仓库
logologo
开始

概述

第一步
控制器
提供者
模块
中间件
异常过滤器
管道
守卫
拦截器
自定义装饰器

基础

自定义提供程序
异步提供者
动态模块
注入作用域
循环依赖
模块引用
懒加载模块
执行上下文
生命周期事件
发现服务
平台无关
单元测试

技术

配置
SQL
Mongo
验证
缓存
序列化
版本控制
任务调度
队列
日志
Cookies
事件
压缩
文件上传
文件流
HTTP 模块
Session
MVC
性能(Fastify)
SSE

安全

认证
授权
加密与哈希
Helmet
CORS
CSRF
速率限制

GraphQL

快速开始
解析器
变更
订阅
标量
指令
接口
联合与枚举
字段中间件
类型映射
插件
复杂度
扩展
CLI 插件
生成SDL
共享模型
其他功能
联邦

WebSocket

网关
异常过滤器
管道
守卫
拦截器
适配器

微服务

基础
Redis
MQTT
NATS
RabbitMQ
Kafka
gRPC
自定义传输
异常过滤器
管道
守卫
拦截器
部署
独立应用程序

CLI

概述
工作区
库
用法
脚本

OpenAPI

介绍
装饰器
类型映射
操作
其他特性
安全
类型与参数
CLI 插件

实用示例

REPL
CRUD生成器
SWC
Passport(认证)
热重载
MikroORM
TypeORM
Mongoose
Sequelize
路由模块
Swagger
健康检查
CQRS
Compodoc
Prisma
Sentry
静态资源
Commander
异步本地存储
Necord
套件(原Automock)

常见问题

Serverless
HTTP 适配器
长连接
全局前缀
原始请求体
混合应用
HTTPS & 多服务器
请求生命周期
错误

开发工具

概述
CI/CD
迁移指南
API参考(官方)

生态与案例

谁在用
精彩资源

支持

支持

社区

贡献者

最后更新于: 2025/11/18 02:11:37

上一页部署
下一页概述

#独立应用程序

有几种方式来挂载 Nest 应用程序。您可以创建 Web 应用程序、微服务或仅仅是一个裸露的 Nest 独立应用程序(没有任何网络监听器)。Nest 独立应用程序是围绕 Nest IoC 容器的包装器,它持有所有实例化的类。我们可以直接使用独立应用程序对象从任何导入的模块中获取对任何现有实例的引用。因此,您可以在任何地方利用 Nest 框架,包括例如脚本化的 CRON 作业。您甚至可以在其上构建 CLI。

#入门

要创建 Nest 独立应用程序,请使用以下构造:

async function bootstrap() {
  const app = await NestFactory.createApplicationContext(AppModule);
  // 您的应用程序逻辑在这里...
}
bootstrap();

#从静态模块检索提供者

独立应用程序对象允许您获取在 Nest 应用程序中注册的任何实例的引用。让我们假设我们在 TasksModule 模块中有一个 TasksService 提供者,该模块由我们的 AppModule 模块导入。这个类提供了一组我们想要从 CRON 作业中调用的方法。

const tasksService = app.get(TasksService);

要访问 TasksService 实例,我们使用 get() 方法。get() 方法就像一个查询,在每个注册的模块中搜索实例。您可以将任何提供者的令牌传递给它。或者,为了严格的上下文检查,传递一个带有 strict: true 属性的选项对象。启用此选项后,您必须导航通过特定模块以从选定的上下文中获取特定实例。

const tasksService = app.select(TasksModule).get(TasksService, { strict: true });

以下是从独立应用程序对象检索实例引用的可用方法摘要。

get() 检索应用程序上下文中可用的控制器或提供者(包括守卫、过滤器等)的实例。
select() 导航模块图以拉出选定模块的特定实例(与上述严格模式一起使用)。
提示

在非严格模式下,默认选择根模块。要选择任何其他模块,您需要手动导航模块图,逐步进行。

请记住,独立应用程序没有任何网络监听器,因此任何与 HTTP 相关的 Nest 功能(例如,中间件、拦截器、管道、守卫等)在此上下文中都不可用。

例如,即使您在应用程序中注册了全局拦截器,然后使用 app.get() 方法检索控制器的实例,拦截器也不会被执行。

#从动态模块检索提供者

当处理动态模块时,我们应该提供与在应用程序中注册的动态模块相同的对象给 app.select。例如:

export const dynamicConfigModule = ConfigModule.register({ folder: './config' });

@Module({
  imports: [dynamicConfigModule],
})
export class AppModule {}

然后您可以稍后选择该模块:

const configService = app.select(dynamicConfigModule).get(ConfigService, { strict: true });

#终止阶段

如果您希望 Node 应用程序在脚本完成后关闭(例如,对于运行 CRON 作业的脚本),您必须在 bootstrap 函数的末尾调用 app.close() 方法,如下所示:

async function bootstrap() {
  const app = await NestFactory.createApplicationContext(AppModule);
  // 应用程序逻辑...
  await app.close();
}
bootstrap();

如生命周期事件章节中所述,这将触发生命周期钩子。

#示例

完整的工作示例可在这里找到。