MongoDB: 环境搭建与mongosh：MongoDB开发环境全配置

# 1. 安装 Docker Desktop for Mac (Apple Silicon)
# 从 https://www.docker.com/products/docker-desktop/ 下载

# 2. 拉取 MongoDB 镜像
docker pull mongo:7.0

# 3. 启动 MongoDB 容器（端口映射 + 数据卷）
docker run -d \
  --name mongodb-dev \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  mongo:7.0

# 4. 用 mongosh 连接
mongosh "mongodb://localhost:27017/admin"

# 5. 测试连接
db.runCommand({ ping: 1 })
# { ok: 1 }

# 检查 mongosh 版本
mongosh --version
# mongosh 2.1.0

# 检查 mongod 服务端版本
mongod --version
# db version v7.0.5

# 通过 mongosh 检查服务端版本
mongosh "mongodb://localhost:27017" --eval "db.version()"
# 7.0.5

test> // MongoDB shell 操作成功

# 安装 Docker Desktop
# macOS: 下载 https://www.docker.com/products/docker-desktop/
# Windows: 下载 + 启用 WSL 2 后端
# Linux: sudo apt install docker.io docker-compose

# 验证 Docker 安装
docker --version
# Docker version 24.0.7, build afdd53b

# 拉取最新稳定版
docker pull mongo:7.0

# 拉取特定版本（推荐）
docker pull mongo:7.0.5

# 拉取带认证的镜像（生产环境推荐）
docker pull mongo:7.0-auth

# 单机开发模式（无认证）
docker run -d \
  --name mongodb-dev \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  --restart unless-stopped \
  mongo:7.0

# 带认证的生产模式
docker run -d \
  --name mongodb-prod \
  -p 27017:27017 \
  -v ~/mongodb-data:/data/db \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=YourSecurePass123 \
  --restart unless-stopped \
  mongo:7.0

# 验证容器运行状态
docker ps
# CONTAINER ID   IMAGE      STATUS         PORTS
# a1b2c3d4e5f6   mongo:7.0  Up 2 minutes   0.0.0.0:27017->27017/tcp

# 用 mongosh 连接
mongosh "mongodb://localhost:27017"

# 在 mongosh 内执行
db.runCommand({ ping: 1 })
# { ok: 1 }

# 查看容器日志
docker logs mongodb-dev

# 停止容器
docker stop mongodb-dev

# 启动容器
docker start mongodb-dev

# 重启容器
docker restart mongodb-dev

# 进入容器内部
docker exec -it mongodb-dev mongosh

# 删除容器（数据卷保留）
docker rm mongodb-dev

# 删除容器和数据卷（慎用！数据丢失）
docker rm -v mongodb-dev

# 添加 MongoDB 官方 Tap
brew tap mongodb/brew

# 安装最新稳定版
brew install mongodb-community@7.0

# 启动 MongoDB 服务
brew services start mongodb-community@7.0

# 验证
mongosh --version
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"

# 启动 mongod（指定数据目录和日志文件）
mongod --dbpath ~/mongodb-data --logpath ~/mongodb.log --fork

# 验证
ps aux | grep mongod
# mongodb  12345  ... mongod --dbpath /Users/.../mongodb-data

# === 1. 安装 Xcode Command Line Tools ===
xcode-select --install

# === 2. 安装 Homebrew（如果还没有） ===
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# === 3. 添加 MongoDB Tap ===
brew tap mongodb/brew

# === 4. 安装 MongoDB ===
brew install mongodb-community@7.0

# === 5. 启动服务 ===
brew services start mongodb-community@7.0

# === 6. 连接测试 ===
mongosh "mongodb://localhost:27017"

# === 7. 第一个命令 ===
db.runCommand({ ping: 1 })
# { ok: 1 }

test> // MongoDB shell 操作成功

# 1. 导入 MongoDB GPG 密钥
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

# 2. 添加 MongoDB 源
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# 3. 更新包索引
sudo apt update

# 4. 安装 MongoDB
sudo apt install -y mongodb-org

# 5. 启动服务
sudo systemctl start mongod
sudo systemctl enable mongod

# 6. 验证
sudo systemctl status mongod
mongosh --eval "db.runCommand({ ping: 1 })"

# 1. 添加 MongoDB Yum 源
sudo tee /etc/yum.repos.d/mongodb-org-7.0.repo << 'EOF'
[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc
EOF

# 2. 安装
sudo yum install -y mongodb-org

# 3. 启动
sudo systemctl start mongod
sudo systemctl enable mongod

1. 访问 https://www.mongodb.com/try/download/community
2. 选择 "Windows" + "msi" + 版本 7.0
3. 下载 MongoDB-windows-x86_64-7.0.x-signed.msi
4. 双击安装：
   ✅ Complete 安装类型
   ✅ Install MongoDB as a Service
   ✅ Install MongoDB Compass（GUI 工具）
5. 完成安装后，MongoDB 自动作为 Windows 服务启动

# 1. 安装 Chocolatey（如果还没有）
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 2. 安装 MongoDB
choco install mongodb

# 3. 启动
mongod --dbpath C:\data\db

# 4. 连接
mongosh "mongodb://localhost:27017"

# === 1. 创建数据目录 ===
mkdir C:\data\db

# === 2. 启动 MongoDB ===
mongod --dbpath C:\data\db

# === 3. 另一个终端连接 ===
mongosh "mongodb://localhost:27017"

# === 4. 测试 ===
db.runCommand({ ping: 1 })
# { ok: 1 }

// 执行成功

1. 访问 https://www.mongodb.com/cloud/atlas/register
2. 注册账号（Google / GitHub OAuth 最快）
3. 选择 "Build a Cluster" → "Shared" → "M0 Sandbox"（免费）
4. 云提供商：AWS（推荐）
5. 区域：
   - 中东用户：me-central-1 (UAE)
   - 巴西用户：sa-east-1 (São Paulo)
   - 日本用户：ap-northeast-1 (Tokyo)
6. 集群名称：Cluster0
7. 点击 "Create Cluster"（等待 1-3 分钟）

步骤 1：创建数据库用户
- Database Access → Add New Database User
- Username: alice
- Password: YourSecurePass123
- Database User Privileges: Read and write to any database

步骤 2：配置网络白名单
- Network Access → Add IP Address
- 选择 "Allow Access from Anywhere"（0.0.0.0/0）
  ⚠️ 仅开发用，生产环境应限制为应用服务器 IP

1. Database → Connect → Connect your application
2. Driver: Node.js
3. Version: 5.5 or later
4. 连接字符串：
   mongodb+srv://alice:YourSecurePass123@cluster0.mongodb.net/mydb?retryWrites=true&w=majority

# 用 mongosh 连接 Atlas
mongosh "mongodb+srv://cluster0.mongodb.net/mydb" --username alice
# Password: ********

# 在 mongosh 内执行
db.runCommand({ ping: 1 })
# { ok: 1 }

# 插入第一个文档
db.users.insertOne({ name: "Alice", email: "alice@example.com" })

# 查询
db.users.find()
# { _id: ObjectId('...'), name: 'Alice', email: 'alice@example.com' }

test> // MongoDB shell 操作成功

# 连接本地默认端口
mongosh

# 连接指定主机和端口
mongosh "mongodb://localhost:27017"

# 连接 Atlas
mongosh "mongodb+srv://cluster0.mongodb.net/mydb" --username alice

# 连接并执行单条命令
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"

# 启用 verbose 模式（查看每个命令的耗时）
mongosh --verbose

// === 数据库操作 ===
show dbs                    // 列出所有数据库
use shopdb                  // 切换到 shopdb 数据库（不存在则隐式创建）
db                          // 显示当前数据库
db.dropDatabase()           // 删除当前数据库

// === 集合操作 ===
show collections            // 列出当前数据库的所有集合
db.createCollection("products")  // 显式创建集合
db.products.drop()          // 删除集合

// === 文档操作 ===
db.products.insertOne({ sku: "PHONE-001", price: 599.99 })
db.products.find()          // 查询所有文档
db.products.find().pretty() // 格式化输出
db.products.countDocuments()  // 统计文档数

// === 帮助命令 ===
help                        // mongosh 内置帮助
db.help()                   // 数据库命令帮助
db.products.help()          // 集合操作帮助

# === 编写脚本（setup-mongosh.js） ===
cat > setup-mongosh.js << 'EOF'
// 切换到 shopdb
use shopdb;

// 创建用户集合
db.users.insertMany([
  { name: "Alice", email: "alice@example.com", age: 28 },
  { name: "Bob", email: "bob@example.com", age: 32 },
  { name: "Charlie", email: "charlie@example.com", age: 25 }
]);

// 创建产品集合
db.products.insertMany([
  { sku: "PHONE-001", title: "Phone X", price: 599.99, stock: 50 },
  { sku: "LAPTOP-001", title: "Laptop Y", price: 1299.99, stock: 20 }
]);

// 查询所有用户
print("Users:");
db.users.find().forEach(printjson);

// 查询所有产品
print("Products:");
db.products.find().forEach(printjson);
EOF

# === 执行脚本 ===
mongosh "mongodb://localhost:27017" setup-mongosh.js

test> // MongoDB shell 操作成功

1. 打开 VSCode
2. Extensions (Ctrl+Shift+X)
3. 搜索 "MongoDB for VS Code"
4. 点击 Install（官方插件，由 MongoDB Inc. 提供）

1. 点击侧边栏 MongoDB 图标
2. 点击 "Add Connection"
3. 输入连接字符串：
   - 本地：mongodb://localhost:27017
   - Atlas：mongodb+srv://cluster0.mongodb.net/mydb
4. 输入用户名密码
5. 选择数据库，浏览集合

- 右键集合 → "View Documents"：浏览数据
- 右键集合 → "Insert Document"：插入文档
- 右键文档 → "Edit Document"：编辑
- 右键文档 → "Delete Document"：删除
- 顶部工具栏 → "Playgrounds"：运行 mongosh 脚本

// VSCode MongoDB Playground
use('shopdb');

db.users.aggregate([
  { $group: { _id: '$age', count: { $sum: 1 } } },
  { $sort: { _id: 1 } }
]);

// 执行成功

// 在 mongosh 内执行
db.runCommand({ ping: 1 });

// 输出：
// { ok: 1 }

// 带时间戳的 ping
const start = Date.now();
const result = db.runCommand({ ping: 1 });
const duration = Date.now() - start;
print(`Ping successful in ${duration}ms`);
printjson(result);

// ping-test.js
const { MongoClient } = require('mongodb');

async function testConnection() {
  const client = new MongoClient('mongodb://localhost:27017');

  try {
    const start = Date.now();
    await client.connect();

    const result = await client.db('admin').command({ ping: 1 });
    const duration = Date.now() - start;

    console.log(`✅ Connected in ${duration}ms`);
    console.log('Ping result:', result);

    if (result.ok === 1) {
      console.log('🎉 MongoDB connection is healthy!');
    } else {
      console.error('❌ Ping failed:', result);
    }
  } catch (err) {
    console.error('❌ Connection error:', err.message);
    process.exit(1);
  } finally {
    await client.close();
  }
}

testConnection();

// health-check.js
const { MongoClient } = require('mongodb');
const mongoose = require('mongoose');

async function healthCheck() {
  const results = {
    native_driver: false,
    mongoose: false,
    timestamp: new Date().toISOString()
  };

  // 1. 测试原生驱动
  try {
    const client = new MongoClient('mongodb://localhost:27017');
    await client.connect();
    const ping = await client.db('admin').command({ ping: 1 });
    results.native_driver = ping.ok === 1;
    await client.close();
    console.log('✅ Native driver ping:', ping.ok === 1);
  } catch (err) {
    console.error('❌ Native driver ping failed:', err.message);
  }

  // 2. 测试 mongoose
  try {
    await mongoose.connect('mongodb://localhost:27017/test');
    const adminDb = mongoose.connection.db.admin();
    const ping = await adminDb.command({ ping: 1 });
    results.mongoose = ping.ok === 1;
    await mongoose.disconnect();
    console.log('✅ Mongoose ping:', ping.ok === 1);
  } catch (err) {
    console.error('❌ Mongoose ping failed:', err.message);
  }

  console.log('\nHealth check results:', JSON.stringify(results, null, 2));
  return results;
}

healthCheck();

✅ Native driver ping:
❌ Native driver ping failed:
✅ Mongoose ping:
❌ Mongoose ping failed:
\nHealth check results:

# 查看容器日志找原因
docker logs mongodb-dev

# 常见错误：端口被占用
# Error: bind: address already in use

# 解决方案 1：停止占用端口的进程
lsof -i :27017
kill -9 <PID>

# 解决方案 2：改用其他端口
docker run -d --name mongodb-dev -p 27018:27017 mongo:7.0
mongosh "mongodb://localhost:27018"

# 检查磁盘空间
df -h

# MongoDB 数据目录默认占用空间
du -sh ~/mongodb-data

# 清理方案：设置 oplogSize 限制（副本集模式）
mongod --oplogSize 1024

# 或使用 WiredTiger 压缩（默认开启）
mongod --wiredTigerCollectionConfig blockCompressor=zstd

# === 步骤 1：检查 mongod 是否在运行 ===
ps aux | grep mongod | grep -v grep

# === 步骤 2：检查端口监听 ===
lsof -iTCP:27017 -sTCP:LISTEN

# === 步骤 3：尝试连接 ===
mongosh "mongodb://localhost:27017"

# === 步骤 4：查看 mongod 日志 ===
tail -50 /usr/local/var/log/mongodb/mongo.log

# === 步骤 5：重启服务 ===
brew services restart mongodb-community@7.0

# === 步骤 6：再次测试 ===
mongosh "mongodb://localhost:27017" --eval "db.runCommand({ ping: 1 })"

test> // MongoDB shell 操作成功