org.springframework.web.client.HttpClientErrorException$Unauthorized: 
401 Unauthorized: "{
    "error": {
        "message": "Incorrect API key provided...",
        "type": "invalid_request_error"
    }
}"

org.springframework.web.client.HttpClientErrorException$TooManyRequests: 
429 Too Many Requests: "{
    "error": {
        "message": "Rate limit reached...",
        "type": "rate_limit_error"
    }
}"

org.springframework.web.ResourceAccessException: 
I/O error on POST request for "https://api.openai.com/v1/chat/completions": 
Connect timed out

// 驗(yàn)證Key是否加載正確
@PostConstruct
public void checkApiKey() {
    String key = System.getenv("OPENAI_API_KEY");
    System.out.println("Key長(zhǎng)度: " + (key != null ? key.length() : 0));
    System.out.println("Key前10位: " + (key != null ? key.substring(0, 10) : "null"));
}

spring:
  ai:
    openai:
      api-key: ${OPENAI_API_KEY}  # 從環(huán)境變量讀取，不要硬編碼
      base-url: https://api.openai.com  # 國(guó)內(nèi)可換代理地址
      chat:
        options:
          model: gpt-3.5-turbo
          temperature: 0.7
          # 超時(shí)配置
      timeout:
        connect: 30000  # 連接超時(shí)30秒
        read: 60000     # 讀取超時(shí)60秒
# 自定義RestTemplate配置（解決超時(shí)和重試）
openai:
  client:
    max-retries: 3           # 最大重試次數(shù)
    retry-delay: 1000        # 重試間隔1秒
    max-connections: 20      # 最大連接數(shù)
    max-connections-per-route: 10  # 單路由最大連接

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
import org.springframework.web.client.DefaultResponseErrorHandler;
import org.springframework.http.HttpStatus;
import org.springframework.http.client.ClientHttpResponse;
import java.io.IOException;
import java.net.InetSocketAddress;
import java.net.Proxy;

@Configuration
public class OpenAIClientConfig {

    @Bean
    public RestTemplate openaiRestTemplate() {
        // 1. 配置超時(shí)
        SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
        factory.setConnectTimeout(30000);  // 30秒連接超時(shí)
        factory.setReadTimeout(60000);     // 60秒讀取超時(shí)

        // 2. 配置代理（國(guó)內(nèi)環(huán)境需要）
        // factory.setProxy(new Proxy(Proxy.Type.HTTP, 
        //     new InetSocketAddress("127.0.0.1", 7890)));

        RestTemplate restTemplate = new RestTemplate(factory);

        // 3. 自定義錯(cuò)誤處理（區(qū)分401/429/其他）
        restTemplate.setErrorHandler(new DefaultResponseErrorHandler() {
            @Override
            public void handleError(ClientHttpResponse response) throws IOException {
                HttpStatus statusCode = (HttpStatus) response.getStatusCode();
                String body = new String(response.getBody().readAllBytes());

                switch (statusCode) {
                    case UNAUTHORIZED:
                        throw new RuntimeException("401: API Key無(wú)效或過(guò)期，請(qǐng)檢查OPENAI_API_KEY。詳情: " + body);
                    case TOO_MANY_REQUESTS:
                        throw new RuntimeException("429: 請(qǐng)求過(guò)于頻繁，請(qǐng)降低調(diào)用頻率或升級(jí)賬戶(hù)。詳情: " + body);
                    case BAD_GATEWAY:
                    case SERVICE_UNAVAILABLE:
                        throw new RuntimeException("502/503: OpenAI服務(wù)暫不可用，請(qǐng)稍后重試。詳情: " + body);
                    default:
                        super.handleError(response);
                }
            }
        });

        return restTemplate;
    }
}

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;
import org.springframework.stereotype.Service;

@Service
public class OpenAIChatService {

    private final ChatClient chatClient;

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

    @Retryable(
        retryFor = {RuntimeException.class},
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)  // 1秒、2秒、4秒退避
    )
    public String chat(String message) {
        return chatClient.prompt()
            .user(message)
            .call()
            .content();
    }
}

// 啟用重試需要在啟動(dòng)類(lèi)加@EnableRetry

import com.google.common.util.concurrent.RateLimiter;
import org.springframework.stereotype.Component;
import java.util.concurrent.TimeUnit;

@Component
public class OpenAIRateLimiter {

    // GPT-3.5限制3500 RPM，這里保守設(shè)置為50/秒
    private final RateLimiter rateLimiter = RateLimiter.create(50.0);

    public void acquire() {
        rateLimiter.acquire();
    }

    public boolean tryAcquire(long timeout, TimeUnit unit) {
        return rateLimiter.tryAcquire(timeout, unit);
    }
}

// 使用
@Service
public class ChatService {
    @Autowired
    private OpenAIRateLimiter rateLimiter;

    public String safeChat(String message) {
        rateLimiter.acquire();  // 阻塞等待獲取令牌
        return chatClient.prompt().user(message).call().content();
    }
}

# 測(cè)試Key是否有效
curl https://api.openai.com/v1/models   -H "Authorization: Bearer $OPENAI_API_KEY"   -H "Content-Type: application/json"
# 測(cè)試對(duì)話接口
curl https://api.openai.com/v1/chat/completions   -H "Authorization: Bearer $OPENAI_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

// 開(kāi)啟HttpClient調(diào)試日志
logging.level.org.springframework.web.client.RestTemplate=DEBUG
logging.level.org.apache.http=DEBUG

@RestController
public class HealthController {

    @Autowired
    private OpenAIChatService chatService;

    @GetMapping("/health/openai")
    public Map<String, Object> checkOpenAI() {
        try {
            String response = chatService.chat("Hi");
            return Map.of(
                "status", "UP",
                "response", response.substring(0, 20),
                "timestamp", System.currentTimeMillis()
            );
        } catch (Exception e) {
            return Map.of(
                "status", "DOWN",
                "error", e.getMessage(),
                "timestamp", System.currentTimeMillis()
            );
        }
    }
}

spring:
  ai:
    openai:
      base-url: https://api.openai-proxy.com  # 第三方代理
      api-key: ${OPENAI_API_KEY}

# 通義千問(wèn)（阿里云）
spring:
  ai:
    dashscope:
      api-key: ${DASHSCOPE_API_KEY}
# 文心一言（百度）
spring:
  ai:
    qianfan:
      api-key: ${QIANFAN_API_KEY}
      secret-key: ${QIANFAN_SECRET_KEY}