DDD架构中用Awilix将数据库层设为单例是否存在风险？

数据老陈

2026-8-25

关于Awilix中数据库层单例注册的疑问

最近下载了一个采用函数式方式实现DDD的Node.js样板代码，分析代码时对Awilix IoC容器中将database注册为单例的做法存在疑惑，以下是container.js中的代码：

const { createContainer, asValue, asFunction } = require('awilix')
// you can do this
const app = require('./app')
const server = require('./interfaces/http/server')
const router = require('./interfaces/http/router')
const auth = require('./interfaces/http/auth')
const config = require('../config')
const logger = require('./infra/logging/logger')
const database = require('./infra/database')
const jwt = require('./infra/jwt')
const response = require('./infra/support/response')
const date = require('./infra/support/date')
const repository = require('./infra/repositories')

const container = createContainer()

// SYSTEM
container
  .register({
    app: asFunction(app).singleton(),
    server: asFunction(server).singleton(),
    router: asFunction(router).singleton(),
    logger: asFunction(logger).singleton(),
    database: asFunction(database).singleton(),
    auth: asFunction(auth).singleton(),
    jwt: asFunction(jwt).singleton(),
    response: asFunction(response).singleton(),
    date: asFunction(date).singleton(),
    config: asValue(config),
    repository: asFunction(repository).singleton()
  })

module.exports = container

疑问：当接口通过仓储层访问数据库时，数据库层是否应该设为单例？担心所有用户共用同一数据库连接会产生不必要的副作用。第一次接触Awilix，看起来确实只使用了一个数据库层实例，想了解这种做法是否安全，是否会引发问题？

解答

将数据库层注册为单例是完全安全且符合Node.js后端开发最佳实践的，核心原因如下：

数据库连接池的天然支持：绝大多数Node.js数据库驱动（如pg、mysql2、MongoDB驱动）默认都会使用连接池机制，而非单个数据库连接。你的database模块内部大概率是初始化了一个连接池，单例的数据库层实例只是持有这个连接池的引用。每次请求会从连接池中获取空闲连接，执行完操作后归还，完全不会出现多个请求共用单个连接导致的并发冲突问题。
避免重复初始化的资源浪费：如果不将数据库层注册为单例，每次依赖注入时都会创建新的数据库层实例，这意味着每次都要重新初始化连接池，会快速耗尽数据库的连接数配额，同时带来大量不必要的初始化开销，严重影响应用性能。
无状态设计保障无副作用：函数式DDD模式下的数据库层通常是无状态的，它仅封装数据库操作的纯函数/方法，不会存储任何请求相关的上下文数据（如当前用户、请求参数）。所有请求上下文都是通过方法参数传递的，因此多个请求共用同一个数据库层实例不会产生任何副作用。
Awilix单例的本质：Awilix的.singleton()只是确保应用生命周期内只存在一个数据库层实例，这个实例本身如果基于连接池实现，就天然具备高并发处理能力，完全不用担心共用实例的安全性问题。

补充说明：如果你的database模块确实是创建单个数据库连接（而非连接池），那才会存在并发问题，但这种实现方式在生产环境中几乎不会被采用——单个连接根本无法支撑高并发请求，专业的数据库驱动默认都会使用连接池来优化性能和并发能力。

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

DDD架构中用Awilix将数据库层设为单例是否存在风险？

解答 #

解答