MySQL未启动是Drupal数据库连接失败的主因；需检查XAMPP中MySQL状态、端口占用、strict mode配置及settings.php权限，多实例部署时须同步修改my.ini端口、sql_mode、host为127.0.0.1并确保各实例数据目录与权限独立。
MySQL 服务没启动，Drupal 就根本连不上数据库
多端口部署的前提是 MySQL 能正常响应连接请求。XAMPP 中 Apache 和 MySQL 是两个独立进程，Apache 启动了不代表 MySQL 也在跑。安装 Drupal 时卡在“数据库配置”页、提示“无法连接到数据库服务器”，90% 的情况不是密码错，而是 MySQL 根本没运行。
实操建议：
- 打开 xampp-control.exe，检查 MySQL 行右侧状态是否为 Running；
- 若显示 Stopped，点 Start 并等待变绿；
- 若点击后立刻回退为 Stopped，查 xampp\mysql\data\mysql_error.log 最后一行错误——常见是端口 3306 被 Skype、其他 MySQL 实例或安全软件占用；
- 确认启动后，在浏览器访问 http://localhost/phpmyadmin/ 能打开，才算真正就绪。
改 MySQL 端口必须同步改 Drupal 的 database URL 和 my.ini 配置
想让多个 Drupal 实例共存，最直接的方式是给每个实例配独立 MySQL 端口（比如 3307、3308），但只改 my.ini 不够，Drupal 安装时填的 host + port 必须匹配，否则会报 Connection refused。
实操建议：
- 编辑 xampp\mysql\bin\my.ini，在 [mysqld] 段下添加：port = 3307（不要删掉原 3306 段，那是主实例）；
- 复制整个 mysql 文件夹为 mysql3307，修改其 my.ini 中的 basedir 和 datadir 指向新路径，并确保 port 唯一；
- 启动新实例：用命令行执行 xampp\mysql3307\bin\mysqld --defaults-file=xampp\mysql3307\bin\my.ini；
- Drupal 安装时，“Host” 填 127.0.0.1（别用 localhost，Windows 下会走 socket 而非 TCP），“Port” 填 3307；
- 若用 settings.php 手动配置，$databases 数组里要写成 'host' => '127.0.0.1', 'port' => 3307。
strict mode 导致多实例安装中途失败
新版 XAMPP（如 8.2+）默认开启 MySQL 严格模式，而 Drupal 8/9 的部分表结构不显式声明 DEFAULT 值，就会在建表时报 Field 'xxx' doesn't have a default value，安装中断。这个问题在多端口部署时容易被忽略——因为每个 MySQL 实例的 sql_mode 是独立配置的。
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
实操建议：
- 对每个自定义端口的 MySQL 实例（如 mysql3307），都要单独编辑其 my.ini；
- 在对应 [mysqld] 段下添加：sql_mode = "NO_ENGINE_SUBSTITUTION"；
- 修改后必须重启该实例，不能只靠 reload；
- 验证方式：用 phpMyAdmin 或命令行连上该端口，执行 SELECT @@sql_mode;，结果中不应含 STRICT_TRANS_TABLES。
文件权限和 settings.php 写入问题在多站点下更易出错
多个 Drupal 实例共享同一份 XAMPP 安装，但每个站点的 sites/default/settings.php 和 sites/default/files 必须可写。Windows 下常因 UAC 或继承权限丢失导致安装卡在 “Verify requirements” 步骤，Mac/Linux 下则更容易因用户组归属错乱而失败。
实操建议：
- 每个 Drupal 子目录（如 htdocs/drupal-a、htdocs/drupal-b）都要单独执行：cp sites/default/default.settings.php sites/default/settings.php；
- 然后手动设权限：chmod 644 sites/default/settings.php（Linux/macOS），或右键属性 → 安全 → 编辑当前用户“写入”权限（Windows）；
- sites/default/files 目录需存在且可写，若不存在，先创建再赋权；
- 不要用符号链接跨实例复用 settings.php，Drupal 会校验文件硬链接或 inode，可能触发安全拒绝。
多端口部署 Drupal 的核心复杂点不在 Apache 配置，而在每个 MySQL 实例的独立性——端口、sql_mode、数据目录、权限策略都得一一对应，漏改一个，安装就静默失败。尤其注意 localhost 和 127.0.0.1 在不同系统下的解析差异，这是最容易被跳过的坑。
