使用Docker Compose部署Cassandra遇cqlsh连接错误及初始化脚本问题

一、cqlsh连接错误的原因及修复 #

问题点1：环境变量配置错误 #

你的docker-compose里写的CASSANDRA_PASS=cassandra是错误的，Bitnami Cassandra镜像的正确环境变量是CASSANDRA_PASSWORD，日志里也明确提示了这个变量，配置错误会导致认证失败或服务异常。

问题点2：服务未完全就绪就连接 #

从日志最后一行能看到，Cassandra还在等待节点同步，此时服务没完全启动，直接连接肯定失败。

问题点3：连接命令参数不全 #

本地用cqlsh连接时，没指定用户名、密码或者正确的主机地址，也会触发连接错误。

修复步骤： #

1. 修正docker-compose的环境变量：

environment:
  - CASSANDRA_USER=cassandra
  - CASSANDRA_PASSWORD=cassandra
  - CASSANDRA_CQL_PORT_NUMBER=9042

2. 等待服务完全就绪：日志出现Cassandra就绪的提示后再连接，或者用命令强制等待：

docker exec -it <你的容器名> cqlsh -u cassandra -p cassandra --wait-for-service 60

3. 使用正确的命令连接：
   本地装了cqlsh的话：

cqlsh localhost 9042 -u cassandra -p cassandra

没装cqlsh的话直接进入容器执行：

docker exec -it <你的容器名> cqlsh -u cassandra -p cassandra

二、init.cql初始化脚本未生效的原因及修复 #

问题点1：挂载路径不对 #

Bitnami Cassandra镜像只会自动执行/docker-entrypoint-initdb.d/目录下的脚本，你当前的挂载没把脚本放到这个目录，自然不会执行。

问题点2：数据卷已有数据，跳过初始化 #

如果之前启动过容器，cassandra_data卷里已经有数据库数据，Bitnami镜像会跳过初始化流程，脚本不会再运行。

问题点3：脚本权限或语法错误 #

脚本文件权限不可读，或者CQL语句有语法错误，也会导致执行失败。

修复步骤： #

1. 修改docker-compose的volumes配置，把脚本挂载到指定目录：

volumes:
  - 'cassandra_data:/bitnami'
  - ./init.cql:/docker-entrypoint-initdb.d/init.cql:ro

（./init.cql替换成你本地脚本的实际路径）
2. 清空已有数据卷后重启：

docker-compose down -v
docker-compose up -d

3. 检查脚本：确保CQL语句正确，本地文件权限设为可读（比如chmod 644 init.cql）。

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