Spring Data Couchbase 4中@N1qlPrimaryIndexed注解过时，求替代方案

Hey there! Great question—when Spring Data Couchbase 4 launched, the @N1qlPrimaryIndexed annotation was deprecated as part of a broader refactor of the index management APIs. Here are the clean, supported alternatives you can use:

1. 使用@Indexed(primary = true)注解（推荐） #

The simplest replacement is the @Indexed annotation with the primary attribute set to true. This unified annotation handles both primary and secondary indexes now, replacing the old N1QL-specific primary index annotation.

Your updated repository code would look like this:

@Repository
@Indexed(primary = true)
public interface HostelRepository extends CouchbaseRepository<Hostel, String> { }

This will create the same primary index that @N1qlPrimaryIndexed used to, but fits into the modern, consolidated index management system of Spring Data Couchbase 4.

2. 编程式创建主索引（适合自定义场景） #

If you need more control over index creation (like setting a custom index name, configuring ignoreIfExists, or triggering index creation at a specific time), you can use the CouchbaseTemplate to create the index programmatically.

Here's an example in a configuration class:

@Configuration
public class CouchbaseIndexConfiguration {

    private final CouchbaseTemplate couchbaseTemplate;

    // Constructor injection (preferred over @Autowired in modern Spring)
    public CouchbaseIndexConfiguration(CouchbaseTemplate couchbaseTemplate) {
        this.couchbaseTemplate = couchbaseTemplate;
    }

    @PostConstruct
    public void setupPrimaryIndex() {
        couchbaseTemplate.indexOps(Hostel.class)
            .createPrimaryIndex(PrimaryIndexCreationOptions.indexOptions()
                .ignoreIfExists(true) // Avoid errors if index already exists
                .indexName("custom_hostel_primary_idx")); // Optional custom name
    }
}

This approach gives you full flexibility for edge cases where annotation-based configuration isn't enough.

3. 手动创建索引（Couchbase控制台） #

As a fallback, you can always create the primary index directly in the Couchbase Web Console or via the cbq shell using N1QL:

CREATE PRIMARY INDEX ON `your-bucket-name` IGNORE IF EXISTS;

This is useful if you prefer managing indexes outside of your application code.

为什么@N1qlPrimaryIndexed被废弃？ #

Spring Data Couchbase 4 refactored the index management layer to be more consistent and less tied to specific query languages. The @Indexed annotation now serves as a single entry point for both primary and secondary index configuration, simplifying the API surface.

内容的提问来源于stack exchange，提问作者Sandro Rey