Node.js Express应用中全局定义PostgreSQL连接变量的最佳实践

你的当前实现其实已经完美踩中了Node.js生态里共享数据库连接的最佳实践！让我给你拆解下为什么这能生效，以及可以微调的细节：

为什么你的db.js能实现全局共享连接 #

pg-promise本身会自动管理连接池，而你在db.js里创建的db对象是个单例的连接池实例——Node.js的模块缓存机制会帮你兜底：不管其他模块多少次require('./db')，都会直接复用第一次导出的db对象，不会重复执行模块代码、不会重复创建连接池。

核心实现拆解 #

先看你的db/db.js关键代码：

const pgp = require('pg-promise')(options);
const connectionString = process.env.PG_CONN_STR;
const db = pgp(connectionString); // 只创建一次连接池实例

module.exports = { pgp, db }; // 导出单例

这里的核心逻辑是：

• 仅初始化一次pgp(connectionString)，生成的db是连接池的唯一入口
• Node.js模块系统会缓存这个导出结果，所有其他模块导入的都是同一个db实例

你的表操作模块（比如db/location.js）通过导入获取共享连接的方式完全正确：

var db_global = require('./db');
var db = db_global.db; // 拿到全局共享的连接池

// 业务逻辑函数...
module.exports = { getAllLocations, getLocation, createLocation, updateLocation, removeLocation };

路由层（routes/index.js）通过引入表操作模块间接使用共享连接，也是标准的分层写法：

var db = require('../db/location');

router.get('/api/locations', db.getAllLocations);
router.get('/api/location/:id', db.getLocation);
// ...其他路由配置

可以优化的小细节 #

1. 简化导入语法：在表操作模块里用解构导入更简洁：

const { db } = require('./db');

2. 补全错误处理逻辑：你的app.js里错误处理函数没写完，建议补全以保证异常能正确响应：

// error handler
app.use(function(err, req, res, next) {
  // 开发环境返回详细错误，生产环境隐藏敏感信息
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};

  // 返回错误状态码和页面
  res.status(err.status || 500);
  res.render('error');
});

3. 避开全局变量陷阱：你当前没有用global对象挂载连接，这是非常好的选择！用模块导出共享是Node.js的标准方案，比全局变量更安全、更易维护，也更符合模块化设计思想。

验证连接共享的小技巧 #

你可以在db.js的connect回调里加个计数，或者在不同模块里打印db对象的引用地址（比如console.log(db)），会发现所有模块里的db都是同一个实例，证明连接池确实是全局共享的。

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