本文介绍如何使用 go 语言通过 http 客户端或专用 sdk（如 `go-solr`）安全、高效地连接本地运行的 apache solr 实例（如 `http://localhost:8983/solr/`），并完成基础索引与查询操作。
Apache Solr 是一个高性能、可扩展的全文搜索平台，而 Go 作为现代云原生应用的首选语言之一，天然适合与其集成。由于 Solr 本身基于 HTTP 提供 RESTful API（默认端口 8983，路径 /solr/），Go 可通过标准 net/http 包直接调用，也可借助社区维护的封装库提升开发效率与类型安全性。
✅ 推荐方式：使用 go-solr 客户端库
github.com/rtt/Go-Solr 是一个轻量、稳定、支持 Solr 4.x–9.x 的 Go 客户端，提供结构化请求构造、自动 URL 编码、JSON 响应解析及错误处理能力。
1. 安装依赖
go get github.com/rtt/Go-Solr
2. 基础连接与查询示例
假设你的 Solr 实例运行在 http://localhost:8983/solr/，且已创建名为 mycore 的核心（Core）：
package main
import (
"fmt"
"log"
"github.com/rtt/Go-Solr"
)
func main() {
// 初始化客户端：指定 Solr 地址和核心名
client := solr.New("http://localhost:8983", "mycore")
// 执行简单查询（如搜索所有文档）
resp, err := client.Select(&solr.Params{
Q: "*:*",
Rows: 10,
})
if err != nil {
log.Fatal("Solr query failed:", err)
}
fmt.Printf("Found %d documents\n", resp.Response.NumFound)
for _, doc := range resp.Response.Docs {
fmt.Printf("ID: %v, Content: %v\n", doc["id"], doc["content"])
}
}⚠️ 注意事项：确保 Solr 核心已正确启动（可通过 http://localhost:8983/solr/#/~cores/mycore 在管理界面确认）；若启用身份验证（如 Basic Auth），需在初始化时传入凭证：solr.NewWithAuth("http://localhost:8983", "mycore", "user", "pass")；Solr 9+ 默认启用 HTTPS 和认证，本地开发建议先关闭安全配置或适配 TLS 客户端；写入数据前请确保 schema 中已定义对应字段（如 id, content, title），否则会返回 400 Bad Request。
3. 替代方案：纯 HTTP 手动调用（无依赖）
若仅需轻量交互，也可直接使用 net/http 构造请求：
import (
"bytes"
"encoding/json"
"io"
"net/http"
)
func simpleSolrPing() error {
resp, err := http.Get("http://localhost:8983/solr/mycore/admin/ping")
if err != nil {
return err
}
defer resp.Body.Close()
io.Copy(io.Discard, resp.Body)
return nil
}但此方式需自行处理 JSON 序列化、错误码映射与重试逻辑，不推荐用于生产环境复杂操作。
✅ 总结
连接 Go 与 Solr 的关键在于：明确 endpoint（URL + core） + 选择合适抽象层级（SDK vs raw HTTP） + 验证 schema 与权限配置。对于大多数项目，推荐优先采用 go-solr，它屏蔽了底层协议细节，提供类型安全的参数构建与响应结构体，显著降低出错概率。部署前务必在本地 curl 验证 Solr 可达性（如 curl "http://localhost:8983/solr/mycore/select?q=*:*&rows=1"），再集成到 Go 应用中。
