Spring Boot Kotlin自动注入报错：找不到NonExistentClass类型Bean

问题分析 #

核心问题是Spring容器无法识别WebsocketService Bean，导致自动注入失败。常见诱因包括依赖缺失、包扫描范围不匹配、注入方式存在初始化顺序隐患，或是类/注解拼写错误。

解决方案步骤 #

1. 确保WebFlux依赖已引入 #

ReactorNettyWebSocketClient属于Spring WebFlux模块，若项目未引入该依赖，会导致WebsocketService依赖的Bean无法创建，进而影响自身的Bean注册。

• Gradle配置（build.gradle.kts）：

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-webflux")
    // 其他项目依赖...
}

• Maven配置（pom.xml）：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webflux</artifactId>
    </dependency>
    <!-- 其他项目依赖 -->
</dependencies>

2. 优化注入方式（推荐参数注入） #

字段注入（@Autowired lateinit var）可能存在初始化顺序问题，改用@Bean方法参数注入更稳妥，Spring会自动在容器中匹配并注入目标Bean：

修正后的主应用类代码：

import com.example.twitchbot.websocket.WebsocketService
import org.springframework.boot.CommandLineRunner
import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
import org.springframework.context.annotation.Bean

@SpringBootApplication
class TwitchbotApplication {

    @Bean
    fun initializeWebSocketConnection(websocketService: WebsocketService): CommandLineRunner {
        return CommandLineRunner {
            websocketService.connectToTwitchWebSocket()
        }
    }
}

fun main(args: Array<String>) {
    runApplication<TwitchbotApplication>(*args)
}

3. 验证包扫描范围 #

@SpringBootApplication默认扫描主类所在包及其所有子包。确认WebsocketService所在的com.example.twitchbot.websocket是主类TwitchbotApplication所在包com.example.twitchbot的子包；若不在扫描范围内，需添加@ComponentScan指定路径：

@SpringBootApplication(scanBasePackages = ["com.example.twitchbot", "其他需要扫描的包路径"])
class TwitchbotApplication {
    // ...
}

4. 检查类与注解的正确性 #

• 确认WebsocketService上的@Service注解是org.springframework.stereotype.Service，而非自定义注解；
• 核对类名、包名拼写是否完全一致（注意大小写，比如是否误写为WebSocketService）。

额外提醒 #

代码中connectToTwitchWebSocket方法使用block()会阻塞主线程，生产环境建议改用非阻塞方式（如subscribe()），避免影响应用启动流程。

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