XAMPP 不内置 MongoDB 服务，需手动运行 mongod 并配置 PHP mongodb 扩展；常见失败原因有三：扩展装错、服务未启、连接串错误；phpinfo 显示扩展仅说明驱动加载成功，不代表 mongod 正在运行。
XAMPP 本身不提供 MongoDB 服务，也不能通过控制面板“启用”它——你必须独立运行 mongod 进程，并让 PHP 通过 mongodb 扩展连接它。装错扩展、漏启服务、连接串写法错误，这三类问题占了本地调试失败的 90% 以上。
为什么 phpinfo() 显示 mongodb 但连接失败？
这是最典型的误判：看到 mongodb 出现在 phpinfo 页面，就以为“数据库连上了”。其实那只说明 PHP 加载了驱动，mongod 进程可能根本没在跑。
- 用命令行验证服务是否真在监听：
netstat -ano | findstr :27017（Windows）或lsof -i :27017（macOS/Linux），有输出才代表mongod正在工作 - 如果没输出，别急着重装 PHP 扩展，先检查
mongod --dbpath "C:\mongodb\data\db"是否成功执行，日志里有没有 permission denied 或 data directory not found -
php_mongodb.dll加载成功 ≠ MongoDB 服务可用；前者是“会说话”，后者是“有人听”
extension=php_mongodb.dll 还是 extension=mongodb？
必须写 extension=mongodb ——PHP 加载扩展时只认模块名，不认文件名。写成 extension=php_mongodb.dll 或 extension=mongodb.dll 都会报 Unable to load dynamic library。
- 下载的 DLL 文件名可能是
php_mongodb-1.20.0-8.2-ts-vc17-x64.dll，但 php.ini 里只写extension=mongodb - 确认线程安全（TS）匹配：XAMPP 默认开启 TS，选带
ts标识的 DLL；若用的是非 TS 版 PHP（极少见），则必须选nts - 位数必须一致：XAMPP 是 64 位就选 x64，32 位选 x86；混用会触发
%1 is not a valid Win32 application
PHP 脚本里 new MongoDB\Client 报 Class not found？
因为 MongoDB\Client 不是驱动自带的类，它来自 Composer 包 mongodb/mongodb。只装了 mongodb 扩展，没装这个包，就会报错。
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer require mongodb/mongodb（确保项目根目录有vendor/） - 脚本开头必须加：
require_once __DIR__ . '/vendor/autoload.php'; - 如果不想用 Composer，可改用底层驱动：
$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017');，它不依赖外部包 - 注意：旧教程里的
MongoClient（无 \）已废弃，PHP 7.0+ 完全不可用
连接后 insertOne() 报 “database name cannot be empty”？
这不是连接问题，是写法错误。MongoDB\Client 构造时传的 URI 里的数据库名（如 mongodb://localhost:27017/myapp 中的 myapp）只是默认值，不自动绑定上下文；所有操作仍需显式指定库和集合。
- 正确写法：
$collection = $client->selectDatabase('myapp')->selectCollection('users'); - 错误写法：
$db = $client->myapp; $collection = $db->users; $collection->insertOne([...]);——这种“属性访问”方式仅在旧版 mongo 扩展中存在，mongodb扩展不支持 - 数据库名不能含
.、$、空格；以system.开头的名称被保留，也不能用
最容易被忽略的一点：XAMPP 的 Apache 和 CLI 使用的 php.ini 往往不是同一个文件。用 php --ini 查 CLI 配置路径，用 phpinfo() 查 Web 环境路径——两个地方都得加上 extension=mongodb，否则浏览器能连、命令行连不上，或者反过来。
