Node.js中Singleton类创建与使用报错问题排查及方案咨询

先搞定你眼前的错误：TypeError: Singleton.createInstance is not a function #

这个问题其实很简单——你的Singleton模块没在Node.js里正确导出。Node.js里每个文件都是独立模块，必须通过module.exports把内部对象暴露出去，不然require之后拿到的就是个空对象，自然找不到createInstance方法。

修改你的mySingleton.js，在最后加上一行导出代码就行：

var mySingleton = (function() {
 let instance;
 let message;
 function createInstance() {
 if (!instance)
 instance = { setMessage, getMessage };
 return instance;
 }
 function setMessage(newMessage) {
 message = newMessage;
 }
 function getMessage() {
 return message;
 }
 return { createInstance }
})();

// 关键：把单例对象导出给Node.js模块系统
module.exports = mySingleton;

这样再require的时候，就能拿到带createInstance方法的对象了。

顺便说一句，你的Singleton写法可以优化得更符合常规习惯，比如把createInstance改成getInstance，语义更清晰：

const mySingleton = (function() {
  let instance;
  let message;

  // 初始化实例的内部方法
  function init() {
    return {
      setMessage: (newMessage) => { message = newMessage; },
      getMessage: () => message
    };
  }

  return {
    getInstance: () => {
      if (!instance) {
        instance = init();
      }
      return instance;
    }
  };
})();

module.exports = mySingleton;

使用的时候就改成const firstInstance = Singleton.getInstance();，逻辑更直观。

你的Singleton方案是否适合需求？ #

你的需求是在一个API里存变量，另一个API里取，用Singleton是完全可行的，但要注意两个点：

• 单进程场景下没问题：Node.js是单线程事件循环，同步的变量读写不会有并发冲突；
• 多进程场景会失效：如果以后用cluster模块开多个进程，每个进程会有自己的Singleton实例，变量没法跨进程共享，这时候就得换外部存储了。

更简洁的替代方案 #

其实不用手写Singleton，Node.js本身就提供了更简单的方式来实现跨模块共享变量：

1. 直接用普通模块导出对象 #

Node.js的模块是单例缓存的——第一次require后，模块的导出结果会被缓存，后续所有require都会拿到同一个对象。所以你可以写个极简的共享模块：

// sharedData.js
let message = '';

module.exports = {
  setMessage: (newMsg) => { message = newMsg; },
  getMessage: () => message
};

然后在API里直接用：

const sharedData = require('./sharedData');

app.post('/readyforunlock', (req, res) => {
  sharedData.setMessage("Message");
  console.log(sharedData.getMessage());
  res.send(sharedData.getMessage());
});

app.get('/get-message', (req, res) => {
  res.send(sharedData.getMessage());
});

这种方式和你的Singleton效果完全一样，但代码更简洁，不用自己实现单例逻辑。

2. 用Express的app.locals #

如果只是在Express应用内部共享，直接用app.locals更方便——它是挂载在Express app实例上的全局对象，整个应用都能访问：

// 初始化app的时候
const app = express();
app.locals.sharedMessage = '';

// 接口里使用
app.post('/readyforunlock', (req, res) => {
  app.locals.sharedMessage = "Message";
  console.log(app.locals.sharedMessage);
  res.send(app.locals.sharedMessage);
});

app.get('/get-message', (req, res) => {
  res.send(app.locals.sharedMessage);
});

这种方式不用额外写模块，适合和Express深度绑定的场景。

3. 外部存储（多进程/分布式场景） #

如果以后你的应用要扩展成多进程或者多个部署实例，内存共享的方案就失效了，这时候得用外部存储：

• Redis：轻量的键值对数据库，读写速度极快，适合共享简单变量；
• 数据库（MySQL/MongoDB）：适合需要持久化或者结构复杂的数据。

总结 #

1. 先给你的Singleton模块加上module.exports，就能解决当前的错误；
2. 单进程Express应用里，用普通模块或者app.locals比手写Singleton更简单；
3. 未来如果要做多进程/分布式，记得换成Redis这类外部存储。

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