Spring AI 프로젝트 설정 시 발생하는 의존성 문제 및 해결 방법

Spring AI를 사용하는 스프링 부트 프로젝트에서 spring-ai-openai-spring-boot-starter 라이브러리가 제대로 다운로드되지 않는 경우가 있습니다. 아래는 주요 문제점과 해결 전략입니다.

1. 외부 저장소 설정이 무시되는 문제

기본적으로 Maven의 공식 저장소에서는 spring-ai-openai-spring-boot-starter를 찾을 수 없습니다. 이는 Spring Milestone 저장소에만 존재하기 때문입니다. 단순히 pom.xml에 저장소를 추가해도 효과가 없을 수 있으며, 실제로는 Maven 설정 파일(settings.xml)에 저장소 정보를 명시해야 합니다.

다음과 같이 settings.xml에 저장소를 추가하세요:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>spring-milestones</id>
      <repositories>
        <repository>
          <id>spring-milestones</id>
          <name>Spring Milestones</name>
          <url>https://repo.spring.io/milestone</url>
          <snapshots>
            <enabled>false</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>spring-milestones</activeProfile>
  </activeProfiles>
</settings>

2. JDK 17로 업그레이드 후 실행 오류

JDK 17을 사용하면서 다음과 같은 에러가 발생할 수 있습니다:

Internal error (java.lang.reflect.InaccessibleObjectException): 
Unable to make protected void java.util.ResourceBundle.setParent(java.util.ResourceBundle) accessible: 
module java.base does not "opens java.util" to unnamed module @bef2d72

이 문제는 자바 9 이후 도입된 모듈 시스템에서 java.util.ResourceBundle의 내부 메서드 접근이 제한되기 때문에 발생합니다. 임시 해결책으로는 다음의 VM 옵션을 추가하세요:

--add-opens=java.base/java.util=ALL-UNNAMED

IDEA나 터미널에서 실행 시 해당 옵션을 포함하여 실행하면 대부분의 경우 문제가 해결됩니다.

3. 의존성 구성 예시

다음은 전체 pom.xml 구성 예시입니다. spring-ai-bom을 통해 버전 관리를 하고, 정확한 저장소 설정이 필요합니다.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.5</version>
        <relativePath/>
    </parent>

    <groupId>com.ldj.ai</groupId>
    <artifactId>open-ai</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>open-ai</name>
    <description>OpenAI integration with Spring Boot</description>

    <properties>
        <java.version>17</java.version>
        <spring-ai.version>1.0.0-M1</spring-ai.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>${spring-ai.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <artifactId>junit-jupiter</artifactId>
                    <groupId>org.junit.jupiter</groupId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.5.0</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
        </dependency>
    </dependencies>

    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

4. 간단한 컨트롤러 예제

OpenAI와의 대화 기능을 구현하는 컨트롤러 예시입니다.

package com.ldj.ai.openai.controller;

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/openai")
public class ChatController {

    private final ChatClient chatClient;

    public ChatController(ChatClient.Builder chatClientBuilder) {
        this.chatClient = chatClientBuilder.build();
    }

    @GetMapping("/chat")
    public String generate(@RequestParam(value = "question", defaultValue = "자신을 한 줄로 소개해줘") String question) {
        return chatClient.prompt()
                .user(question)
                .call()
                .content();
    }
}

이 코드는 기본적인 챗 기능을 제공하며, `question` 파라미터로 질문을 전달하면 응답을 반환합니다.