Node.js使用node-persist报错：storage.setItem is not a function

错误原因 #

1. node-persist未初始化：node-persist库在调用任何存储方法前必须完成初始化操作，否则其导出的对象不会包含setItem等可用方法，这是直接触发报错的核心原因。
2. 变量名冲突（隐藏问题）：你在try块中用const res = await storage.setItem(...)声明变量，覆盖了Express路由的响应对象res，即使setItem正常工作，后续的res.status()调用也会报错。

修复步骤 #

• 在启动Express服务前，先完成node-persist的初始化；
• 避免变量名冲突，不要用res作为存储操作的返回值变量名；
• 修正错误状态码（501表示"未实现"，服务器内部错误应使用500）。

修正后的完整代码 #

const express = require("express");
const storage = require("node-persist");
const cors = require("cors");
const app = express();

app.use(express.json());
app.use(cors());

// 初始化node-persist存储
async function initStorage() {
  await storage.init({
    dir: 'tasks-storage', // 可选：指定存储文件的目录，默认在当前目录下的node-persist/storage
    continuous: true // 自动持久化到文件
  });
}

app.post("/addtask", async(req, res) => {
    const {id, task} = req.body;
    try{
        // 用其他变量名接收存储操作返回值，避免覆盖响应对象
        const storageResult = await storage.setItem(id, task);
        res.status(201).send("task added");
    }
    catch(error){
        res.status(500).send({message: "some error occured", error: error.message});
        console.log(error);
    }
});

// 先初始化存储，再启动服务
initStorage().then(() => {
  app.listen(5000, () => {
    console.log("Server running on port 5000");
  });
}).catch(err => {
  console.error("Failed to initialize storage:", err);
});

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