Yearning项目AI模块BaseUrl配置失效问题分析

问题背景

Yearning作为一款开源的SQL审核平台，其AI模块提供了文本转SQL等智能化功能。在实际部署中，管理员可能需要将AI服务的请求地址从默认的OpenAI官方API(api.openai.com)切换到其他自定义域名，比如企业内网部署的AI服务地址或第三方代理地址。

问题现象

管理员在后台配置了AI服务的BaseUrl后，系统在实际请求时仍然向api.openai.com发送请求，导致配置的自定义域名未能生效。这会影响企业内网环境或需要使用代理访问AI服务的场景。

技术分析

通过代码审查发现，在ai.go文件中存在配置遗漏问题。虽然系统在model.GloAI中存储了管理员配置的BaseUrl，但在实际创建AI客户端时，没有将这个配置应用到客户端的BaseURL属性上。

正确的实现应该是在初始化AI客户端时，添加如下代码：

config.BaseURL = model.GloAI.BaseUrl

影响范围

此问题会影响所有依赖AI服务的功能模块，特别是：

1. 文本转SQL功能
2. 智能SQL建议功能
3. 其他基于AI的辅助功能

解决方案

修复方案相对简单，只需在创建AI客户端时正确应用配置即可。具体实现需要考虑以下几点：

1. 配置优先级处理：当BaseUrl为空时，应回退到默认的OpenAI地址
2. URL格式校验：确保配置的BaseUrl格式正确，包含协议头(http/https)
3. 错误处理：当配置的地址不可达时，应有适当的错误提示

最佳实践建议

1. 配置验证：在管理员界面添加BaseUrl的测试连接功能，确保配置正确
2. 日志记录：在AI模块中添加详细的请求日志，记录实际使用的BaseUrl
3. 缓存处理：考虑对AI客户端实例进行适当缓存，避免频繁创建

总结

这个问题的修复虽然代码改动量小，但对于Yearning的AI功能灵活性至关重要。正确的BaseUrl配置能够支持更多部署场景，特别是在企业内网环境或需要特殊网络配置的情况下。开发团队应当重视配置项的实际应用验证，确保所有配置都能正确生效。