Testcontainers-Java项目中Cassandra容器启动问题分析

问题背景

在使用Testcontainers-Java项目的最新版本(1.20.2)时，用户报告了一个关于Cassandra容器启动失败的问题。具体表现为当使用DataStax Enterprise(DSE) 6.8.47版本的镜像时，容器无法正常启动，出现连接拒绝的错误。

技术细节分析

Testcontainers-Java项目在最新版本中对Cassandra容器的实现进行了重构。旧版本使用Cassandra Session来执行检测服务器是否就绪的语句，而新版本改为使用cqlsh命令行工具。这一变更导致了对DSE发行版的支持出现了问题。

错误日志显示：

Connection error: ('Unable to connect to any servers', {'127.0.0.1:9042': error(111, "Tried connecting to [('127.0.0.1', 9042)]. Last error: Connection refused")})

解决方案验证

经过项目维护者的测试验证，发现以下配置可以正常工作：

CassandraContainer cassandraContainer = new CassandraContainer(
    DockerImageName.parse("datastax/dse-server:6.8.47")
    .asCompatibleSubstituteFor("cassandra"))
    .withEnv("DS_LICENSE", "accept");

关键点说明：

1. 必须使用.asCompatibleSubstituteFor("cassandra")来声明镜像兼容性
2. 需要设置DS_LICENSE=accept环境变量接受许可协议

性能考量

在ARM架构设备上通过模拟运行x86镜像时，可能会出现多次连接尝试失败的情况。这是由于启动时间较长导致的正常现象，并非功能性问题。项目维护者建议在后续版本中调整这些临时性错误日志的级别，以改善用户体验。

最佳实践建议

对于使用DSE镜像的用户，建议：

1. 确保使用正确的镜像标签和兼容性声明
2. 设置必要的环境变量
3. 对于初始化脚本，需要指定withWorkingDirectory("/")，因为DSE容器默认工作目录是/opt/dse
4. 给予足够的启动时间，特别是在跨架构模拟环境中

结论

虽然最初报告的问题在标准配置下无法复现，但这一案例揭示了在不同环境和配置下容器启动行为的差异性。Testcontainers项目团队将持续优化Cassandra容器的兼容性和日志输出，以提供更稳定的测试环境支持。