使用Express、Angular和Azure Cosmos DB开发MongoDB应用时的键错误集合问题

嘿，我看到你第一次用Express、Angular搭配Azure Cosmos DB（兼容MongoDB API）开发时，碰到了集合或键相关的错误。结合你给出的代码片段，我整理了几个高频问题点和对应的解决方法，应该能帮你搞定：

1. 先把MongoDB连接配置补全（你的mongo.js还没写完哦） #

Azure Cosmos DB的Mongo API连接有特定要求，你得把mongo.js补成这样才对：

const mongoose = require('mongoose');
mongoose.Promise = global.Promise;
const env = require('./path-to-your-env-file'); // 这里要填对环境变量文件的路径

// 用Azure门户里拿到的真实信息替换环境变量
const mongoUri = `mongodb://${env.COSMOS_DB_USERNAME}:${env.COSMOS_DB_PASSWORD}@${env.COSMOS_DB_HOST}:${env.COSMOS_DB_PORT}/?ssl=true&replicaSet=globaldb&retrywrites=false&maxIdleTimeMS=120000&appName=@${env.COSMOS_DB_ACCOUNT_NAME}@`;

mongoose.connect(mongoUri, {
  useNewUrlParser: true,
  useUnifiedTopology: true,
  useCreateIndex: true // 你的schema里有unique约束，这个配置必须加
})
.then(() => console.log('成功连上Azure Cosmos DB啦！'))
.catch(err => console.error('连接出错：', err));

这里几个关键细节别漏：

• 必须加ssl=true，Azure Cosmos DB强制要求SSL连接
• retrywrites=false，目前Cosmos DB的Mongo API不支持重试写入
• 环境变量里的用户名、密码、主机这些信息，一定要从Azure门户的Cosmos DB账户页面复制，别写错

2. 确保集合名称和Cosmos DB的配置匹配 #

你的hero.model.js里指定了collection: 'Heroes'，这里要注意两个点：

• 如果是手动在Azure门户创建容器，容器名称必须是Heroes；要是不想手动创建，就去Cosmos DB账户设置里开启「MongoDB自动创建集合」功能
• 分区键的设置要对应上：如果没手动指定分区键，Cosmos DB会默认用_id；但你自定义了id字段，要是想把它作为分区键，得在schema里加上对应字段，比如_partitionKey: { type: Number, required: true }，同时在Azure门户把容器的分区键设为/_partitionKey

3. 处理自定义id和Mongoose默认_id的冲突 #

你在schema里定义了自定义的id作为唯一主键，但Mongoose会自动生成_id（ObjectId类型），这很可能和Cosmos DB的键规则冲突。有两种解决办法：

• 如果你就想用自己的id当主键，直接禁用Mongoose的默认_id：

const heroSchema = new Schema({
  id: { type: Number, required: true, unique: true },
  name: String
}, { 
  collection: 'Heroes',
  _id: false // 关掉默认的_id字段
})

• 或者，保留默认的_id，把自定义的id当成普通的唯一字段用，这样更贴合MongoDB的规范

4. 别漏了权限和防火墙检查 #

去Azure门户看看Cosmos DB的防火墙设置，确保你的应用服务器IP在允许访问的列表里；另外，连接字符串里的用户名是Cosmos DB的账户名，密码是主密钥/次级密钥，别搞混了。

5. 精准调试错误 #

要是还是报错，就在mongo.js里加更详细的错误捕获，比如：

mongoose.connect(mongoUri, { ...options })
.catch(err => {
  console.error('完整错误详情：', err);
  console.error('错误代码：', err.code);
  console.error('错误信息：', err.message);
});

根据错误代码（比如18是认证失败，404是集合找不到），就能快速定位问题啦。

内容的提问来源于stack exchange，提问作者Volodymyr M. Yovchenko