MongoDB索引创建报错：存在等价但名称及配置不同的索引

从错误日志可以明确：MongoDB判定你尝试创建的full.eng_text文本索引与已存在的full.uk_text是等价索引，因此拒绝创建。

MongoDB判断文本索引等价的核心依据是索引的key结构，而非索引名称、权重或关联字段。你创建的两个索引key都是{ _fts: "text", _ftsx: 1 }（这是MongoDB文本索引的内部key格式），因此被判定为重复索引，触发CommandException。

另外注意到两个索引的default_language都设为english，这对乌克兰语文本的搜索会有问题，应该对应设置为ukrainian。

1. 清理现有冲突索引 #

先登录MongoDB Shell，定位到目标集合，执行以下命令：

// 查看所有索引，确认冲突索引
db.your_collection_name.getIndexes()
// 删除已存在的乌克兰语索引
db.your_collection_name.dropIndex("full.uk_text")

2. 修改索引创建逻辑 #

2.1 创建独立的多语言文本索引

针对不同语言字段创建索引时，明确指定字段作为索引key，确保MongoDB识别为不同索引：

// 示例：根据当前语言动态创建对应字段的文本索引
$lang = Yii::$app->language;
$field = $lang === 'uk' ? 'full.uk' : 'full.eng';
$indexName = "full.{$lang}_text";
$defaultLang = $lang === 'uk' ? 'ukrainian' : 'english';

// 先检查索引是否存在
$indexExists = false;
foreach ($collection->listIndexes() as $index) {
    if ($index['name'] === $indexName) {
        $indexExists = true;
        break;
    }
}

if (!$indexExists) {
    $collection->createIndex(
        [$field => 'text'],
        [
            'name' => $indexName,
            'weights' => [$field => 1],
            'default_language' => $defaultLang,
            'language_override' => 'language'
        ]
    );
}

2.2 避免重复创建索引

不要在请求链路（比如GoogleMapsApi构造函数）中执行索引创建逻辑，改为通过控制台命令在部署时一次性创建所有需要的索引：

// 编写Yii2控制台命令示例
class IndexController extends Controller
{
    public function actionCreateTextIndexes()
    {
        $collection = Yii::$app->mongodb->getCollection('your_collection');
        
        // 创建乌克兰语索引
        $collection->createIndex(['full.uk' => 'text'], [
            'name' => 'full.uk_text',
            'weights' => ['full.uk' => 1],
            'default_language' => 'ukrainian',
            'language_override' => 'language'
        ]);
        
        // 创建英语索引
        $collection->createIndex(['full.eng' => 'text'], [
            'name' => 'full.eng_text',
            'weights' => ['full.eng' => 1],
            'default_language' => 'english',
            'language_override' => 'language'
        ]);
        
        echo "Text indexes created successfully\n";
    }
}

部署时执行：php yii index/create-text-indexes

3. 验证修复效果 #

重启应用后，切换语言测试搜索功能，确认不再触发500错误，同时检查MongoDB索引是否正常创建：

db.your_collection_name.getIndexes()

内容的提问来源于stack exchange，提问作者Andriy Martsun