Spring AI忽略配置自动使用gpt-4o致模型不存在错误排查

• Spring AI版本升级的默认模型变更
  部分Spring AI新版本可能将OpenAI客户端的默认模型从gpt-3.5-turbo调整为gpt-4o，即使未显式配置模型参数，框架会自动 fallback到默认值。核对项目依赖的Spring AI starter版本，查看对应版本的官方变更日志确认默认模型是否发生调整。

• 配置属性未正确生效

  • 检查配置文件的格式与路径：确认使用的application.yaml/application.properties文件路径正确，属性名是否准确（例如正确属性应为spring.ai.openai.model）。
  • 排查环境变量覆盖：系统环境变量中若设置了SPRING_AI_OPENAI_MODEL=gpt-4o，会优先加载该值覆盖配置文件内容。可通过启动日志打印或系统环境变量列表验证。

• 自动配置类的隐式影响
  项目若引入了额外的Spring AI扩展starter或自定义自动配置类，这些组件可能暗中修改了模型配置逻辑，强制指定gpt-4o作为默认模型。检查项目依赖中的starter清单，排查是否存在此类扩展组件。

• 缓存或依赖冲突

  • 清理Maven/Gradle本地缓存，重新拉取所有依赖，避免旧版本依赖残留导致的配置逻辑异常。
  • 检查是否存在多个版本的OpenAI相关依赖，不同版本的依赖可能存在配置逻辑冲突，导致模型参数被意外覆盖。

• 代码中的隐式配置

  • 排查是否存在@Configuration类通过代码动态设置模型参数，或使用Spring表达式（SpEL）从外部配置源读取模型值，而该外部源已被修改为gpt-4o。
  • 检查是否有AOP切面、拦截器等组件，在运行时修改了AI客户端的模型参数。

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