集成Akka.Persistence.EventStore(v1.5.46)与EventStoreDB遇问题：gRPC错误及事件未持久化

兼容的EventStoreDB版本 #

Akka.Persistence.EventStore 1.5.46 经实测稳定兼容以下版本：

• EventStoreDB 21.10.x LTS（长期支持版）
• EventStoreDB 22.10.x LTS
• KurrentDB对应上述开源版的商业分支版本

更高版本（如23.x+）的EventStoreDB对gRPC接口做了较多调整，容易出现404/500这类兼容性错误；过低版本（如20.x及以下）则可能不支持插件依赖的gRPC特性。

额外HOCON配置（超出README基础配置） #

除官方文档里的基础连接配置外，需补充以下关键设置以避免无响应或通信错误：

akka.persistence {
  journal {
    plugin = "akka.persistence.journal.event-store"
    event-store {
      class = "Akka.Persistence.EventStore.Journal.EventStoreJournal, Akka.Persistence.EventStore"
      connection-string = "esdb://localhost:2113?tls=false"
      # 强制使用与Akka.NET一致的序列化器
      serializer = "hyperion" # 或你项目中使用的序列化器，如json
      # 配置gRPC客户端超时，避免无响应
      grpc {
        deadline = 10s
        retry-policy {
          max-attempts = 3
          backoff = 1s
        }
      }
    }
  }

  snapshot-store {
    plugin = "akka.persistence.snapshot-store.event-store"
    event-store {
      class = "Akka.Persistence.EventStore.Snapshot.EventStoreSnapshotStore, Akka.Persistence.EventStore"
      connection-string = "esdb://localhost:2113?tls=false"
      serializer = "hyperion"
    }
  }
}

# 开启插件调试日志，排查无响应问题
akka.loggers = ["Akka.Logger.Serilog.SerilogLogger, Akka.Logger.Serilog"]
akka.loglevel = "DEBUG"
akka.persistence.journal.event-store.debug-logging = on
akka.persistence.snapshot-store.event-store.debug-logging = on

注意：如果使用EventStoreDB的TLS安全端口（默认2113是无TLS，2112是TLS），需调整连接字符串并配置证书信任：

connection-string = "esdb://localhost:2112?tls=true&tlsVerifyCert=false"

（生产环境建议配置合法证书，关闭tlsVerifyCert=false）

问题排查补充 #

1. 检查EventStoreDB服务器日志：在EventStoreDB的安装目录下查看logs文件夹，确认是否有连接拒绝、权限错误等信息，很多无响应问题是服务器端拒绝了连接但客户端没返回明确错误。
2. 验证gRPC端口连通性：用grpcurl工具测试EventStoreDB的gRPC接口是否正常，比如执行grpcurl -plaintext localhost:2113 list，如果能返回接口列表说明gRPC服务正常。

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