应前置缓存至请求发出前,单进程用map/lrumap,多实例用redis并确保php与node.js共享key;php需清理缓冲、设置utf-8响应头;过期策略应由php通过x-cache-ttl或x-data-version动态控制;须配置熔断、重试与fallback机制。

Node.js 调用 PHP 接口时重复请求怎么破
直接发 HTTP 请求调 PHP,每次都要走网络、等 PHP 启动、执行逻辑、返回结果——哪怕数据根本没变,耗时也照旧。这不是慢,是冤枉慢。
关键不在 Node.js 或 PHP 本身,而在「请求是否真有必要」。缓存必须前置到请求发出前,而不是等响应回来再存。
- 用
Map或LRUMap做内存缓存,适合单进程、短生命周期场景;键建议用method + url + JSON.stringify(params)拼接,避免对象引用导致命中失败 - 若部署多实例,得上
Redis,但注意:PHP 端也要读同一份缓存(比如 PHP 写cache:php_user_123,Node.js 读同 key),否则两边各缓各的,等于没缓 - 别用
express.static或 Nginx 缓存代替业务层缓存——它们只认 URL,不认 POST body 或 header 中的 auth token,一碰表单提交就失效
PHP 输出内容被 Node.js 读成乱码或空字符串
常见于 PHP 开头没关输出缓冲、或用了 echo json_encode($data, JSON_UNESCAPED_UNICODE) 但没设 header,Node.js 的 axios 或 fetch 就可能把 UTF-8 BOM 或 warning 输出一起当响应体收了。
- PHP 端务必在输出前加
ob_end_clean()清掉已有缓冲,再header('Content-Type: application/json; charset=utf-8') - Node.js 端用
axios时,检查response.headers['content-type']是否含charset=utf-8;若缺失,手动用iconv-lite转 Buffer,别依赖默认编码 - 开发期可在 PHP 文件顶部加
error_reporting(0); ini_set('display_errors', '0');,屏蔽 notice/warning 干扰 JSON 结构
缓存过期策略写死在 Node.js 里很危险
PHP 接口的数据更新节奏由后端逻辑决定,比如用户资料改了要立刻失效,但地区列表一周才更新一次。Node.js 自己拍脑袋设个 60 * 1000 毫秒过期,极易引发脏读或频繁穿透。
立即学习“PHP免费学习笔记(深入)”;
- 让 PHP 在响应 header 中带自定义字段,例如
X-Cache-TTL: 3600,Node.js 读它来动态设置缓存时效 - 更稳的做法是 PHP 返回
X-Data-Version: v20240520,Node.js 把它拼进缓存 key,版本一变 key 就失效,不用算时间 - 千万别在 Node.js 里用
setTimeout主动删缓存——进程重启就丢,且多实例下不同步
PHP 接口挂了,Node.js 还在疯狂重试
没熔断、没降级、没 fallback,一个 502 就拖垮整个 Node.js 请求链。尤其当 PHP 是单点 MySQL 前的代理层时,问题会指数放大。
- 用
retry-axios或原生axios的retries配置,但最多 2 次,且加上retryDelay指数退避(如(retry) => 2 ** retry * 100) - 加简单内存熔断:连续 3 次超时或 500+ 错误,接下来 60 秒内所有请求直接 reject,不发出去;用
Map存{'php-user-api': { until: Date.now() + 60000 }} - fallback 不一定返回假数据——可以返回上一次成功缓存的结果,并附带
X-Cached-From: memoryheader,前端自己决定要不要提示“数据可能已过期”
缓存不是加个 redis.set() 就完事,真正难的是 PHP 和 Node.js 对「什么算相同请求」「什么时候该失效」「出错时谁兜底」这三件事的理解对齐。少一个对齐点,缓存就从加速器变成定时雷。











