EmbeddedCassandra兼容Cassandra Java 4.x驱动报hints目录访问错误

• 版本逻辑差异：cassandra-unit 4.3.1.0 内嵌的Cassandra内核升级到4.x线，3.x版本的Cassandra启动时如果hints目录不存在会自动递归创建，权限校验逻辑宽松；4.x版本调整了启动校验规则，会直接检查hints目录的存在性与读写权限，校验失败就直接抛出IOException: Unable to open hint directory异常。
• 版本适配bug：cassandra-unit 4.3.1.0 存在Windows平台适配缺陷，启动内嵌实例时只会自动创建data、commitlog等核心工作目录，遗漏了hints目录的预创建逻辑，同时对Windows路径的反斜杠转义处理存在问题，会出现路径拼接错误，导致进程找不到目标目录、无法完成读写校验。
• 驱动兼容变化：升级到java-driver-core 4.x后，驱动不再自动兼容旧版cassandra-unit的默认目录配置覆盖逻辑，进一步放大了上述目录缺失的问题。

• 提前手动创建工作目录：在测试代码初始化内嵌Cassandra的逻辑前，通过Java NIO工具递归创建所有需要的工作子目录，参考实现：

  Path cassandraWorkDir = Paths.get("target/embeddedCassandra");
  Files.createDirectories(cassandraWorkDir.resolve("hints"));
  Files.createDirectories(cassandraWorkDir.resolve("data"));
  Files.createDirectories(cassandraWorkDir.resolve("commitlog"));
  Files.createDirectories(cassandraWorkDir.resolve("saved_caches"));
  // 目录创建完成后再执行EmbeddedCassandraServerHelper.startEmbeddedCassandra()启动逻辑
  

• 显式指定配置路径：自定义cassandra.yaml配置文件加载到cassandra-unit中，显式配置hints_directory、data_file_directories、commitlog_directory等目录参数为提前创建好的绝对路径，避免默认路径拼接出错。
• 升级到修复版本：直接将cassandra-unit依赖升级到4.3.2.0及以上版本，该版本已经修复了Windows平台下hints目录未自动创建、路径转义错误的问题，不需要额外修改测试代码即可正常启动。
• Windows环境权限适配：不要将内嵌Cassandra的工作目录设置在C盘根目录、Program Files等受系统UAC权限保护的路径下，尽量放在项目自身的target目录中；同时关闭杀毒软件对该目录的实时扫描，避免文件锁导致进程无法读写目录。

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