SpringBoot启动报UnsatisfiedDependencyException:cassandraSession异常

你遇到的一系列Repository注入报错全是上层连带异常，真正的故障点在错误栈最底层：

Failed to instantiate [com.datastax.oss.driver.api.core.CqlSession]: Factory method 'cassandraSession' threw exception; nested exception is com.datastax.oss.driver.api.core.DriverExecutionException
简单说就是Spring Boot启动时创建Cassandra数据库连接（CqlSession）失败了，后续依赖这个连接的cassandraTemplate、所有自定义Cassandra Repository都没法完成初始化，所以你注释掉第一个Repository的注入，错误就会顺延到下一个Repository上——和你写的单个Repository、Controller业务逻辑没有任何关系。
之前重启就恢复、现在彻底启动失败，结合你用DataStax Astra云Cassandra的配置，按优先级排查以下问题即可：

• 先清掉代码里的低级笔误：你贴出的InboxApp类导入语句里有复制残留的乱码：

  // 错误的导入，多了enter code here的冗余内容
  import org.springframework.boot.autoconfigure.cass`enter code here`andra.CqlSessionBuilderCustomizer;
  

  如果本地代码确实存在这段乱码，直接修正为正确导入：

  import org.springframework.boot.autoconfigure.cassandra.CqlSessionBuilderCustomizer;
  

• 解决依赖版本冲突：你在pom.xml里手动引入了com.datastax.oss:java-driver-core:4.13.0，但Spring Boot 2.5.2版本官方对齐、内置管理的Datastax驱动版本是4.11.1，手动指定不匹配的驱动版本很容易触发初始化兼容问题。直接删掉这段手动加的驱动依赖，让Spring Boot父POM自动引入适配的版本即可，改完执行mvn clean compile重新构建项目。
• 校验Astra连接配置与网络连通性：
  • 检查配置文件（application.yml/application.properties）里的Astra安全连接包（secure connect bundle）路径是否正确，对应文件有没有被误删、移动位置
  • 核对配置的Astra客户端ID、访问密钥是否正确、有没有过期
  • 确认本地网络可以正常连通Astra服务地址，之前偶发重启就好基本都是临时网络波动导致的，现在如果本地网络限制了对应出站端口、或者Astra实例侧临时故障，就会持续连接失败
• 调整初始化逻辑的执行时机：你在@PostConstruct注解的方法里直接执行数据库写入操作，这个阶段Bean本身刚完成属性注入，不代表Cassandra连接、表结构都已经完全就绪，也可能触发驱动执行异常。可以先把init方法里所有Repository写操作全部注释掉，先确认应用能正常启动连上Cassandra，再把初始化逻辑移到ApplicationRunner实现类里执行，保证Spring上下文完全初始化完成后再操作数据库。

1. 修正代码笔误、清理不匹配的依赖，重新构建项目
2. 注释掉初始化方法里的所有数据库操作
3. 核对Astra配置、确认网络连通后启动应用
4. 应用启动成功后，再逐步放开初始化逻辑，确认数据库操作正常

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