Express服务器每10秒调用fs.writeFile写JSON时触发主页意外刷新问题

故障排查与解决方案 #

核心原因（90%以上概率） #

你使用了Node.js服务热重载工具（比如nodemon、supervisor）或者前端构建工具的热重载能力，这类工具默认会监听项目目录下所有文件的修改，你每10秒写入一次entries.json文件的操作会被识别为项目文件变动：

1. 如果是服务端热重载工具监听到文件变化，会自动重启Express服务，前端如果配套开启了live reload能力，检测到服务端重启就会触发页面刷新
2. 如果entries.json存放在前端静态资源目录（比如public、static文件夹）下，前端构建工具（webpack、vite等）的热重载会直接检测到静态文件变更，触发页面刷新

次要排查方向 #

检查前端是否有全局错误处理逻辑：Express服务重启的短暂时间内，前端发起的GET请求会报错，如果有全局的请求错误拦截逻辑里写了location.reload()之类的重载代码，也会触发页面刷新。

解决步骤 #

1. 确认热重载工具的忽略配置
   如果你用的是nodemon，在项目根目录新增nodemon.json文件，写入以下配置忽略data目录的文件变动：

{
  "ignore": ["data/*"]
}

也可以直接在启动命令中加忽略参数：
nodemon --ignore data/ index.js
2. 调整JSON文件的存储位置，不要放在前端静态资源目录、服务端路由目录这类会被热重载工具默认监听的路径下
3. 注释掉定时任务的setInterval(writeToFile, 10000);代码行验证：如果注释后页面不再自动刷新，就可以确认是文件写入触发的热重载导致的问题。

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