[250801] Spring AI - ChatClient 빈 등록 오류 해결

목적

Spring AI의 ChatClient는 OpenAI와의 대화형 API 요청을 편리하게 처리할 수 있도록 도와주는 핵심 컴포넌트이다.

하지만 Spring AI가 제공하는 자동 구성(AutoConfiguration)이 항상 정상 작동을 보장하지 않는 것 같다.

따라서 때에 따라서는 명시적으로 ChatClient 빈을 구성하고 등록하는 것이 더 안정적이다.

---

문제 상황

- AiService 클래스에서 ChatClient를 생성자 주입하려 할 때 다음과 같은 오류가 발생

---

원인 분석

Spring AI의 ChatClient는 기본적으로 자동 구성(@AutoConfiguration)을 통해 등록된다.

하지만 자동 구성 과정에서 필요한 조건들이 충족되지 않을 경우, Spring이 이를 빈으로 등록하지 못할 수 있다고 한다.

---

해결 방법

☑︎ 명시적 빈 등록!

다음과 같이 ChatClient.Builder를 사용하여 직접 빈으로 등록하여 해결할 수 있다.

@Configuration
public class AiConfig {

    @Bean
    /**
     * chatClient(): 
     * chatClientSpring AI에서 자동으로 제공하는 빈으로,
     * ChatClient 인스턴스를 생성할 때 필요한 구성 정보를 내부적으로 담고 있음.
     * (예: model, api-key 등)
     */
    ChatClient chatClient(ChatClient.Builder builder) {
        return builder.build();
    }
}

---

결과

위와 같이 명시적으로 빈 등록을 수행하면 Spring에서 정상적으로 ChatClient 빈을 주입하고, AiService 생성자 주입 오류가 해결되었다.

---

참고 자료

https://mingdodev.github.io/blog/dev/2025-03-22-OpenAI-structred-outputs-with-Spring-AI/