KeystoneJS 默认使用 Node.js 启动（npm run dev），监听 3000 端口，与 XAMPP 的 Apache 完全无关；正确做法是单独运行 KeystoneJS 服务，确保端口未被占用，并直接访问 http://localhost:3000，而非通过 Apache 代理或修改 httpd.conf。
KeystoneJS 默认用 Node.js 启动（npm run dev），和 XAMPP 的 Apache 完全无关——直接在 XAMPP 里“配置多端口支持 KeystoneJS”是方向性错误。你真正需要的是让 KeystoneJS 服务能被浏览器访问，同时不和 Apache 冲突。
为什么不能改 httpd.conf 去“支持”KeystoneJS
Apache 和 KeystoneJS 是两个独立进程：前者监听 80 或 443，后者默认监听 3000（或 port 配置项指定的值）。强行让 Apache 代理 KeystoneJS（比如用 ProxyPass）在本地开发中纯属加戏——既增加配置复杂度，又掩盖真实请求链路，还容易引发 CORS、路径重写、WebSocket 断连等问题。
常见错误现象：listen EADDRINUSE: address already in use :::3000（端口被占）、浏览器打开 localhost 只显示 Apache 默认页、KeystoneJS 启动后页面空白或报 404。
- KeystoneJS 不依赖 Apache，删掉 XAMPP 也能跑
- XAMPP 的
htdocs目录对 KeystoneJS 完全无用 - 修改
Listen 80或加VirtualHost *:3000不生效，因为 Apache 根本不处理 Node.js 的 HTTP Server
正确做法：绕开 Apache，单独运行 KeystoneJS
KeystoneJS 项目根目录下执行 npm run dev，它会自动启动自己的 Express/Koa 服务。你要做的只是确保这个端口没被其他程序占用，并允许浏览器直连。
实操要点：
- 检查端口是否空闲：终端运行
netstat -ano | findstr :3000（Windows）或lsof -i :3000（macOS/Linux），有 PID 就用任务管理器或kill -9 PID干掉 - 确认
keystone.js或index.js中的port配置（如port: process.env.PORT || 3000），别写死成80 - 启动后访问
http://localhost:3000，不是http://localhost—— 后者永远指向 Apache - 如果 KeystoneJS 管理后台需上传文件或调 API，前端请求地址必须显式带端口，例如
fetch('http://localhost:3000/api/posts')
当必须和 PHP 页面共存时，怎么避免 CORS 报错
比如你在 XAMPP 的 htdocs 里放了个 PHP 页面，想用 JS 调 KeystoneJS 的 /api 接口，浏览器会因端口不同触发同源策略拦截，报 CORS error。
开发阶段最轻量的解法是在 KeystoneJS 后端加 CORS 头，而不是动 Apache：
- Keystone v6+：在
keystone.ts的config里加server: { cors: { origin: 'http://localhost' } } - Keystone v5 或 Express 手动集成：用
app.use(cors({ origin: 'http://localhost' })) - 绝对不要在 Apache 的
httpd.conf里加Header set Access-Control-Allow-Origin "*"—— 这会让整个 XAMPP 的 PHP 站点暴露给任意域名
XAMPP 控制面板里的 Shell 为啥找不到 node
点击 XAMPP 的 Shell 按钮打开的 CMD 窗口，默认不加载系统环境变量，所以即使你全局装了 Node.js，node -v 也会报“不是内部或外部命令”。
解决方法很简单：
- Windows：直接用系统自带的 CMD 或 PowerShell 启动 KeystoneJS，别依赖 XAMPP 的 Shell
- macOS/Linux：确认
which node输出的是/usr/local/bin/node而非/Applications/XAMPP/xamppfiles/bin/node；如果不是，检查~/.zshrc是否已把 Node.js 路径加入PATH
真正容易被忽略的是：KeystoneJS 的数据模型变更（如新增字段）必须重启服务才生效，光刷新浏览器没用；而很多人误以为是端口或 Apache 配置问题，反复折腾 httpd-vhosts.conf 却毫无意义。
