Cassandra 4.1加载Trigger Jar时因FileAlreadyExistsException无法启动

问题概述 #

使用Cassandra 4.1的Trigger功能时，初始化阶段加载Jar文件失败，抛出异常：

java.nio.file.FileAlreadyExistsException: /tmp/lib/cassandra-0.jar

日志显示加载/etc/cassandra/triggers/cassandra-logger-0.2.jar时触发该异常，直接导致Cassandra停止服务并关机。更换hms-cassandra-triggers-1.0.1.jar等其他Jar文件后，问题依然复现。

可能原因 #

1. 临时文件残留：Cassandra会将triggers目录下的Jar复制到/tmp/lib/目录，命名为cassandra-N.jar。若之前异常关机、进程强制终止，会导致该临时Jar文件残留，再次启动时无法覆盖。
2. Docker环境挂载问题：若使用Docker部署，/tmp目录挂载到宿主机或未使用临时文件系统，会导致容器重启后临时文件未被清理。
3. 目录权限不足：/tmp/lib/或/etc/cassandra/triggers目录的权限配置不正确，Cassandra运行用户（通常为cassandra）无法删除或写入临时文件。

解决方案 #

1. 清理残留临时Jar文件 #

进入Cassandra容器或服务器，删除/tmp/lib/下的所有Cassandra临时Jar文件：

rm -f /tmp/lib/cassandra-*.jar

如果是Docker环境，建议重启容器时使用tmpfs挂载/tmp，避免宿主机残留文件：

# docker-compose.yaml示例配置
services:
  cassandra:
    image: cassandra:4.1
    volumes:
      - ./cassandra.yaml:/etc/cassandra/cassandra.yaml
      - ./triggers:/etc/cassandra/triggers
      - tmpfs:/tmp  # 用tmpfs挂载临时目录，重启自动清理

2. 修复目录权限 #

确保triggers目录和临时目录的权限属于Cassandra运行用户：

# 修复triggers目录权限
chown -R cassandra:cassandra /etc/cassandra/triggers
chmod -R 755 /etc/cassandra/triggers

# 确保/tmp/lib目录存在且权限正确
mkdir -p /tmp/lib
chown cassandra:cassandra /tmp/lib
chmod 755 /tmp/lib

3. 配置专属临时目录（可选） #

在cassandra.yaml中指定Cassandra专属临时目录，避免与其他进程冲突：

tmp_dir: /var/lib/cassandra/tmp

创建并配置该目录权限：

mkdir -p /var/lib/cassandra/tmp
chown cassandra:cassandra /var/lib/cassandra/tmp
chmod 700 /var/lib/cassandra/tmp

验证步骤 #

1. 启动Cassandra，查看日志确认FileAlreadyExistsException异常不再出现。
2. 执行数据库写入操作（如插入数据），验证Trigger是否正常触发并执行。

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