Docker部署Cassandra配置PasswordAuthenticator后连接失败求助

问题核心原因 #

出现连接拒绝错误的主要原因有两个：

• Windows环境下编辑的文件默认使用CRLF换行符，而Linux容器中的Cassandra仅支持LF换行符，导致YAML配置文件解析失败，Cassandra无法正常启动
• 挂载到容器的配置文件权限不正确，Cassandra进程（以cassandra用户运行）无法读取该文件

诊断步骤 #

先查看容器启动日志，确认具体失败原因：

docker logs cassdb

若日志中出现YAML parse error或Permission denied类信息，即可对应上述原因。

解决方案 #

1. 修复换行符问题

• 打开VS Code加载cassandra.yaml，点击右下角的CRLF按钮，切换为LF后保存文件
• 若使用Git管理配置文件，可全局禁用自动换行转换：

  git config --global core.autocrlf false
  

2. 修复文件权限问题

在Docker Compose中添加启动命令，先修正配置文件权限再启动Cassandra：

cassandra:
    image: cassandra:4.1
    container_name: "cassdb"
    ports:
      - 9042:9042
    volumes:
      - ./cassandra:/var/lib/cassandra
      - ./cassandra.yaml:/etc/cassandra/cassandra.yaml
    environment:
      - CASSANDRA_CLUSTER_NAME=cassclus
    command: /bin/bash -c "chown cassandra:cassandra /etc/cassandra/cassandra.yaml && exec cassandra -f"

3. 正确配置PasswordAuthenticator

修改cassandra.yaml中的认证配置：

authenticator: PasswordAuthenticator
# 可选：如需细粒度权限控制，添加以下配置
authorizer: CassandraAuthorizer

容器启动后，使用默认超级用户连接：

docker exec -it cassdb cqlsh -u cassandra -p cassandra

4. 重置数据目录（若系统表损坏）

如果之前的错误启动导致本地./cassandra数据目录出现损坏，先删除该目录再重新启动：

# Windows命令行
rmdir /s ./cassandra
# PowerShell
Remove-Item -Recurse -Force ./cassandra

内容的提问来源于stack exchange，提问作者Aleix Rué