Lagom项目中Slick+PostgreSQL多键索引引发PSQLException问题

我来帮你搞定这个头疼的问题——你遇到的是Slick在处理createIfNotExists时，针对复合索引的一个已知逻辑缺陷，导致重启应用后重复尝试创建已存在的索引，触发PostgreSQL的"relation already exists"错误（PostgreSQL里索引属于relation的一种）。

问题根源 #

你的表定义里通过index("article_number_fulfiller_idx",(completeArticleNumber,fulfillerVendorNumber),unique = true)定义了复合唯一索引，而Slick 3.3.2的schema.createIfNotExists方法在检查复合索引是否存在时，判断逻辑不准确。每次重启应用执行setGlobalPrepare(table.schema.createIfNotExists)时，它都会错误地认为这个索引不存在，进而重复发送创建索引的SQL，导致PostgreSQL报错。

靠谱的解决方案 #

方案1：手动检查表是否存在再创建（推荐） #

放弃直接用schema.createIfNotExists，改成先检查表是否存在，只有表不存在时才创建表和索引，这样从根源上避免重复操作：

override def buildHandler(): ReadSideProcessor.ReadSideHandler[Article.Event] = readSide
  .builder[Article.Event](ArticleTable.TableName+"_offset")
  .setGlobalPrepare {
    // 先检查表是否存在
    val tableExistsQuery = sql"""
      SELECT EXISTS (
        SELECT FROM information_schema.tables 
        WHERE table_name = ${ArticleTable.TableName}
          AND table_schema = current_schema()
      )
    """.as[Boolean].head

    for {
      exists <- tableExistsQuery
      // 表不存在才创建
      _ <- if (!exists) table.schema.create else DBIO.successful(Done)
    } yield Done
  }
  .setEventHandler[ArticleCreated](insert)
  .setEventHandler[DescriptionAdded](_ => DBIOAction.successful(Done) )
  .setEventHandler[DescriptionRemoved](_ => DBIOAction.successful(Done) )
  .build()

这个方法的好处是逻辑清晰，完全避免了重复创建表和索引的可能，适合生产环境使用。

方案2：用原生SQL创建索引（绕过Slick的缺陷） #

如果你不想改动表创建的逻辑，可以把索引的创建单独抽出来，用PostgreSQL原生的CREATE INDEX IF NOT EXISTS语法，这个语法能正确判断索引是否存在：

// 定义创建索引的原生SQL
val createUniqueIndex = sqlu"""
  CREATE UNIQUE INDEX IF NOT EXISTS article_number_fulfiller_idx 
  ON ${ArticleTable.TableName} (complete_article_number, fulfiller_vendor_number)
"""

override def buildHandler(): ReadSideProcessor.ReadSideHandler[Article.Event] = readSide
  .builder[Article.Event](ArticleTable.TableName+"_offset")
  .setGlobalPrepare {
    for {
      // 先创建表（如果不存在）
      _ <- table.schema.createIfNotExists
      // 再创建索引（如果不存在）
      _ <- createUniqueIndex
    } yield Done
  }
  .setEventHandler[ArticleCreated](insert)
  .setEventHandler[DescriptionAdded](_ => DBIOAction.successful(Done) )
  .setEventHandler[DescriptionRemoved](_ => DBIOAction.successful(Done) )
  .build()

这种方法不需要改动原有的表创建逻辑，只需要补充索引的创建语句，快速解决问题。

方案3：尝试升级Slick版本 #

你当前使用的是Slick 3.3.2，后续的Slick 3.4.x版本修复了一些复合索引的判断问题。不过要注意：Lagom 1.6.2默认依赖特定版本的Slick，升级前要确认依赖兼容性，避免出现版本冲突。如果你的项目对依赖版本兼容性要求不高，可以尝试升级到Slick 3.4.x的稳定版，看是否能解决问题。

额外建议 #

在生产环境中，更规范的做法是使用Flyway或Liquibase这类数据库迁移工具来管理表结构和索引。这类工具会跟踪每一次的结构变更，确保不会重复执行相同的DDL语句，从根本上避免这类重复创建的问题，同时也方便跟踪表结构的变更历史。

内容的提问来源于stack exchange，提问作者André Schmidt