0

0

如何在 Node.js 中动态重新导入已修改的 JSON 模块

花韻仙語

花韻仙語

发布时间:2026-02-21 10:36:01

|

774人浏览过

|

来源于php中文网

原创

如何在 Node.js 中动态重新导入已修改的 JSON 模块

Node.js 默认缓存 require() 加载的模块,导致后续读取 JSON 文件时始终返回首次加载的内容;本文详解如何通过清除模块缓存实现动态重载,并提供安全、可复用的实践方案。

node.js 默认缓存 `require()` 加载的模块,导致后续读取 json 文件时始终返回首次加载的内容;本文详解如何通过清除模块缓存实现动态重载,并提供安全、可复用的实践方案。

在 Node.js 中,require() 不仅用于加载 JavaScript 模块,也支持直接导入 JSON 文件(如 require('./config.json'))。但这一便利性背后隐藏着一个关键机制:所有通过 require() 加载的模块(包括 JSON)都会被缓存在 require.cache 对象中。这意味着,即使文件内容在运行时被修改(例如通过 fs.writeFileSync),下一次 require() 仍会从内存缓存中返回旧数据,而非重新读取磁盘文件。

上述问题在需要“热更新配置”或“状态持久化到 JSON”的场景中尤为常见——比如每次请求递增计数器并写回文件,却始终读到初始值。根本原因正是缓存未失效。

✅ 正确解法:手动清除模块缓存

要强制 Node.js 重新解析并加载最新 JSON 内容,需在 require() 前显式删除对应模块在 require.cache 中的条目。关键点在于:必须使用模块的绝对路径(即 require() 实际解析后的完整路径)作为缓存键,因为 require.cache 的键是规范化后的绝对路径,而非相对路径。

SauceNAO
SauceNAO

SauceNAO是一个专注于动漫领域的以图搜图工具

下载

以下为修复后的完整示例:

const path = require('path');
const fs = require('fs').promises;

// 安全的 JSON 读取函数:自动清除缓存并重新加载
async function readJsonFresh(filePath) {
  const absolutePath = path.resolve(filePath);
  // 清除缓存(注意:必须用绝对路径)
  delete require.cache[absolutePath];
  // 同步 require —— 因为 JSON 是纯数据,无副作用,且需确保读取最新内容
  return require(absolutePath);
}

app.use('/change', async (req, res) => {
  try {
    // 动态读取最新 JSON 内容(绕过缓存)
    const data = await readJsonFresh('./number.json');
    const num = data.number;
    console.log('Current number:', num); // 正确输出 1 → 2 → 3...

    // 修改后写回文件
    await fs.writeFile(
      path.join(__dirname, 'number.json'),
      JSON.stringify({ number: num + 1 }, null, 2),
      'utf8'
    );

    res.status(200).json({ success: true, next: num + 1 });
  } catch (err) {
    console.error('Failed to update JSON:', err);
    res.status(500).json({ error: 'Internal server error' });
  }
});

⚠️ 重要注意事项

  • 路径必须绝对化:require.cache 的键是 path.resolve() 后的绝对路径。若传入 './number.json',缓存键可能不匹配,导致清除失败。务必使用 path.resolve() 或 path.join(__dirname, ...)。
  • require() 是同步操作:虽然 JSON 读取本身轻量,但在高频请求中频繁 require() 可能成为瓶颈。生产环境建议改用 fs.readFile() + JSON.parse() 组合(完全绕过模块系统),更可控且避免缓存干扰:
    const content = await fs.readFile('./number.json', 'utf8');
    const data = JSON.parse(content); // 始终读取磁盘最新内容
  • 缓存清除时机:必须在 require() 之前执行 delete require.cache[...];顺序颠倒将无效。
  • 多进程/集群场景不适用:该方法仅作用于当前 Node.js 进程。若应用部署在 PM2 集群或多实例中,各进程缓存独立,需配合外部存储(如 Redis)实现跨进程状态同步。

✅ 总结

Node.js 的模块缓存机制提升了启动性能,但在需动态读取外部文件的场景下需主动管理。通过精准清除 require.cache 条目,可安全实现 JSON 模块的“按需重载”。对于简单原型或低频服务,delete require.cache + require() 是快捷方案;而对于生产级应用,推荐直接使用 fs.readFile() + JSON.parse(),语义清晰、无缓存副作用、易于测试与调试。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

443

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

322

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

require的用法
require的用法

require的用法有引入模块、导入类或方法、执行特定任务。想了解更多require的相关内容,可以阅读本专题下面的文章。

482

2023.11.27

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

287

2023.11.13

drop和delete的区别
drop和delete的区别

drop和delete的区别:1、功能与用途;2、操作对象;3、可逆性;4、空间释放;5、执行速度与效率;6、与其他命令的交互;7、影响的持久性;8、语法和执行;9、触发器与约束;10、事务处理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.12.29

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

524

2023.06.20

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

796

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 9.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号