直接说结论：XAMPP 中用不同端口跑多个 Bolt CMS 实例完全可行，但必须手动隔离 app/cache、app/database 和 public/files 目录，否则会因共享 SQLite 文件或缓存冲突导致 500 错误或后台无法登录。
为什么 Bolt 在多端口下容易 500 或白屏
Bolt 默认把缓存、数据库和上传文件全放在项目根目录下的 app/cache、app/database/bolt.db、public/files。当你用 http://localhost:8080 和 http://localhost:8081 指向两个 Bolt 项目但共用同一份 XAMPP 的 Apache 进程时，PHP 的 opcache、APCu（如果启用）甚至 SQLite 的文件锁都可能交叉干扰。
常见现象包括：
访问一个端口正常，另一个端口返回 500 Internal Server Error，日志里出现 SQLITE_BUSY 或 Unable to write cache file登录后台后跳转失败，或编辑页面时提示 Token mismatch上传图片成功但前台不显示，public/files 下有文件但 URL 404
httpd-vhosts.conf 中必须写的三件事
不能只靠 DocumentRoot 切换目录——Bolt 的路由和静态资源依赖正确的 public/ 入口和 .htaccess 重写规则。以下配置是底线：
DocumentRoot 必须指向 Bolt 项目的 public 子目录（不是项目根目录），例如 "D:/xampp/htdocs/bolt-blog/public"<directory></directory> 块里必须包含 AllowOverride All，否则 .htaccess 不生效，所有请求 404每个 <virtualhost></virtualhost> 必须显式声明 ServerName localhost:8080（注意带端口），否则 Apache 可能把请求错分给第一个匹配的 <virtualhost></virtualhost>
示例片段：
<VirtualHost *:8080> ServerName localhost:8080 DocumentRoot "D:/xampp/htdocs/bolt-blog/public" <Directory "D:/xampp/htdocs/bolt-blog/public"> AllowOverride All Require all granted </Directory></VirtualHost>
如何让两个 Bolt 实例真正互不干扰
关键不是“复制项目”，而是切断所有共享路径。你得改 Bolt 自己的配置，而不是只靠 Apache：
在每个 Bolt 项目的 app/config/config.yml 中，显式指定独立路径：database: → 改为绝对路径，如 path: D:/xampp/htdocs/bolt-blog/app/database/bolt.dbpaths: → 覆盖 cache: D:/xampp/htdocs/bolt-blog/app/cache、files: D:/xampp/htdocs/bolt-blog/public/files删掉每个项目 app/cache 目录下的全部内容（包括 .gitignore），让 Bolt 启动时重建干净缓存确保两个项目的 composer.json 中 "bolt/bolt" 版本一致，避免因 Twig/Symfony 组件版本差异引发兼容问题
验证和排障最有效的三步
改完别急着刷浏览器。按顺序执行：
在 XAMPP 控制面板点 Config → Apache (httpd.conf)，确认 #Include conf/extra/httpd-vhosts.conf 已取消注释；再检查 Listen 8080 和 Listen 8081 确实存在且未被占用（可用 netstat -ano | findstr :8080 验证）命令行进入 D:\xampp\apache\bin，运行 httpd -t。输出 Syntax OK 才代表虚拟主机配置没写错；若报错，重点看 Invalid command ‘Require’（说明 Apache 版本太低，需升级 XAMPP）打开 error.log（D:\xampp\apache\logs\error.log），过滤关键词 [php] 或 SQLITE，90% 的启动失败原因都在这里，比浏览器报错直接得多
最容易被忽略的是：Bolt 的 config.yml 里 debug: true 默认只在 localhost 生效，换成 localhost:8080 后要手动加 trusted_hosts: [‘localhost:8080’]，否则连 debug 页面都看不到详细错误。
评论(0)