多对多关联带额外列：映射表允许重复及数据保存问题

看起来你在Grails里实现带额外字段的多对多关联时遇到了保存数据的问题——这种场景确实很容易因为关联配置或者保存方式不对踩坑，我帮你梳理下正确的实现步骤和常见问题排查点：

一、先把领域类的映射配置改对 #

首先，带额外列的多对多不能用Grails默认的隐式多对多，必须通过中间类AuthorBook显式关联，而且两边的Author和Book不能直接互相hasMany，得关联到中间类。下面是三个类的正确代码：

1. Author 类 #

class Author {
    String name
    // 关联到中间类AuthorBook，而非直接关联Book
    static hasMany = [authorBooks: AuthorBook]
    static mappedBy = [authorBooks: 'author'] // 明确指定反向关联的属性，避免歧义

    static constraints = {
        name nullable: false, blank: false
    }
}

2. Book 类 #

class Book {
    String title
    // 同样关联到中间类AuthorBook
    static hasMany = [authorBooks: AuthorBook]
    static mappedBy = [authorBooks: 'book']

    static constraints = {
        title nullable: false, blank: false
    }
}

3. AuthorBook 中间类（核心） #

class AuthorBook implements Serializable {
    Author author
    Book book
    String royalty // 你的额外字段

    // 必须正确实现equals和hashCode，因为这类中间类的唯一性由author和book共同决定
    boolean equals(other) {
        if (!(other instanceof AuthorBook)) {
            return false
        }
        // 用id来比较，避免Hibernate的代理对象问题
        other.author?.id == author?.id && other.book?.id == book?.id
    }

    int hashCode() {
        def builder = new HashCodeBuilder()
        builder.append(author?.id)
        builder.append(book?.id)
        builder.toHashCode()
    }

    // 配置复合主键，这是中间类必须的——用author和book的id作为联合主键
    static mapping = {
        id composite: ['author', 'book']
        version false // 不需要版本字段，减少不必要的麻烦
    }

    static constraints = {
        royalty nullable: false, blank: false // 根据你的业务需求调整约束
        author nullable: false
        book nullable: false
    }
}

这里要划重点：

• 别让Author和Book直接互相hasMany，否则Grails会自动生成普通的多对多表，完全忽略你的AuthorBook类。
• AuthorBook必须配置复合主键，否则Hibernate无法识别它的唯一性，保存时会出问题。
• equals和hashCode一定要基于author.id和book.id实现，别直接比较对象本身，因为Hibernate会用代理对象，直接比较会导致判断错误。

二、正确的保存方式 #

很多时候保存失败是因为你没正确创建和关联中间类实例，下面给你两种常见场景的代码示例：

场景1：新建作者、书籍并关联（设置royalty） #

def saveNewAuthorBook() {
    // 先保存作者和书籍，确保它们有持久化的id
    def author = new Author(name: "J.K. Rowling").save(flush: true, failOnError: true)
    def book = new Book(title: "Harry Potter and the Philosopher's Stone").save(flush: true, failOnError: true)

    // 创建中间类实例，关联两者并设置royalty
    def authorBook = new AuthorBook(author: author, book: book, royalty: "15%")
    authorBook.save(flush: true, failOnError: true)

    // 另一种方式：通过Author的集合添加
    // author.addToAuthorBooks(new AuthorBook(book: book, royalty: "15%"))
    // author.save(flush: true, failOnError: true)
}

场景2：关联已存在的作者和书籍 #

def linkExistingAuthorBook() {
    def author = Author.get(1)
    def book = Book.get(1)

    if (author && book) {
        // 先检查是否已经存在关联，避免重复保存
        def existingLink = AuthorBook.findByAuthorAndBook(author, book)
        if (!existingLink) {
            def authorBook = new AuthorBook(author: author, book: book, royalty: "20%")
            authorBook.save(flush: true, failOnError: true)
        }
    }
}

提示：保存时加上failOnError: true很重要，这样如果有错误（比如字段为空、外键约束违反）会直接抛出异常，方便你快速定位问题，而不是默默失败。

三、常见错误排查 #

如果还是保存不了，你可以检查这几点：

• 检查AuthorBook的mapping里是否配置了composite: ['author', 'book']，没有复合主键的话，Grails会给它生成单独的id，这不符合多对多中间类的逻辑，容易导致保存冲突。
• 检查equals和hashCode的实现是否正确，有没有同时比较author.id和book.id——如果只比较其中一个，Hibernate会认为实例重复或者无法识别。
• 查看应用日志或者在代码里捕获异常，看看具体的错误信息，比如是不是author或book为null，或者royalty违反了约束。
• 确认Author和Book的mappedBy配置正确，指向AuthorBook里的author和book属性，避免Grails自动生成错误的关联映射。

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