xampp中用不同端口运行多个bolt cms实例完全可行，但必须手动隔离app/cache、app/database和public/files目录，否则因共享sqlite文件或缓存冲突导致500错误或后台无法登录。
直接说结论：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 重写规则。以下配置是底线：
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
-
DocumentRoot必须指向 Bolt 项目的public子目录（不是项目根目录），例如"D:/xampp/htdocs/bolt-blog/public" -
<directory></directory>块里必须包含AllowOverride All，否则.htaccess不生效，所有请求 404 - 每个
<virtualhost></virtualhost>必须显式声明ServerName localhost:8080（注意带端口），否则 Apache 可能把请求错分给第一个匹配的<virtualhost></virtualhost>
示例片段：
<virtualhost>
ServerName localhost:8080
DocumentRoot "D:/xampp/htdocs/bolt-blog/public"
<directory>
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 页面都看不到详细错误。
