在Go语言中尝试使用标准库rpc/jsonrpc包连接如Bitcoin这样的外部JSON-RPC服务时，开发者常会遇到认证失败或协议不兼容的问题。以下我们将详细分析这些问题及其解决方案。
错误解析：“地址中冒号过多”
原始代码中，尝试使用jsonrpc.Dial("tcp", "user:pass@localhost:8332")连接Bitcoin RPC服务时，会遇到dial tcp user:pass@localhost:8332: too many colons in address user:pass@localhost:8332的错误。这个错误并非Go语言特有，而是源于net.Dial函数对地址格式的期望。
jsonrpc.Dial底层依赖于net.Dial来建立网络连接。net.Dial函数通常期望的TCP地址格式是host:port或IP:port。例如，localhost:8332是一个有效的地址。然而，当地址中包含user:pass@这样的认证信息时，冒号的数量超出了net.Dial的解析预期，因为它不识别这种URL风格的认证语法。因此，尝试在Dial字符串中直接嵌入用户名和密码会导致解析错误。
Go标准库rpc包的认证限制
Go语言的rpc包及其子包jsonrpc，在设计上并没有内置对HTTP Basic Authentication或其他形式的用户认证的支持，尤其不是通过Dial字符串来传递。这意味着，如果你要连接一个需要认证的JSON-RPC服务（如Bitcoin RPC），你不能简单地将用户名和密码放入连接地址中。认证机制需要通过其他方式实现，通常是在HTTP请求头中添加认证信息。
立即学习“go语言免费学习笔记（深入）”；
协议不兼容性：Go jsonrpc与Bitcoin RPC
除了认证问题，更根本的原因在于Go标准库的rpc/jsonrpc包所实现的JSON-RPC协议，与Bitcoin核心（bitcoind）所使用的JSON-RPC协议存在差异。
Go的rpc包及其jsonrpc实现，是为Go程序之间进行RPC通信而设计的，它定义了一套Go特有的序列化和方法调用约定。而Bitcoin的RPC接口遵循的是标准的JSON-RPC 1.0或2.0规范，通常通过HTTP POST请求传输JSON格式的数据。即使你解决了“冒号过多”的地址问题，并成功建立了TCP连接，Go jsonrpc包发送的请求格式也无法被Bitcoin RPC服务器理解，反之亦然。
简单来说，你不能直接使用Go的rpc/jsonrpc包来与非Go语言实现的标准JSON-RPC服务（如Bitcoin RPC）进行通信。
正确连接Bitcoin RPC的方法
要从Go语言中正确连接并与Bitcoin RPC服务交互，你需要采用符合Bitcoin RPC协议的方式。这通常意味着使用HTTP客户端来发送JSON-RPC请求，并手动处理认证。
方法一：手动构建HTTP请求（推荐理解原理）
这种方法涉及使用Go的net/http包来构建HTTP POST请求，并在请求体中包含标准的JSON-RPC数据。同时，你需要手动添加HTTP Basic Authentication头。
package main
import (
"bytes"
"encoding/base64"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
// JSONRPCRequest represents a standard JSON-RPC 1.0/2.0 request structure
type JSONRPCRequest struct {
JSONRPC string `json:"jsonrpc,omitempty"` // For JSON-RPC 2.0
ID interface{} `json:"id"`
Method string `json:"method"`
Params []interface{} `json:"params"`
}
// JSONRPCResponse represents a standard JSON-RPC 1.0/2.0 response structure
type JSONRPCResponse struct {
JSONRPC string `json:"jsonrpc,omitempty"`
Result json.RawMessage `json:"result"`
Error *JSONRPCError `json:"error"`
ID interface{} `json:"id"`
}
// JSONRPCError represents a standard JSON-RPC error structure
type JSONRPCError struct {
Code int `json:"code"`
Message string `json:"message"`
}
func main() {
rpcUser := "your_rpc_username" // 替换为你的Bitcoin RPC用户名
rpcPass := "your_rpc_password" // 替换为你的Bitcoin RPC密码
rpcHost := "localhost"
rpcPort := "8332" // Bitcoin主网默认端口
// 构建认证字符串
auth := rpcUser + ":" + rpcPass
encodedAuth := base64.StdEncoding.EncodeToString([]byte(auth))
// 构建JSON-RPC请求体
requestBody, err := json.Marshal(JSONRPCRequest{
JSONRPC: "1.0", // Bitcoin RPC often uses 1.0, or is compatible with 2.0
ID: "go-jsonrpc-client",
Method: "getblockcount",
Params: []interface{}{}, // getblockcount typically takes no parameters
})
if err != nil {
fmt.Printf("Error marshaling request: %v\n", err)
return
}
// 创建HTTP请求
req, err := http.NewRequest("POST", fmt.Sprintf("http://%s:%s", rpcHost, rpcPort), bytes.NewBuffer(requestBody))
if err != nil {
fmt.Printf("Error creating request: %v\n", err)
return
}
// 添加HTTP Basic Authentication头
req.Header.Add("Authorization", "Basic "+encodedAuth)
req.Header.Add("Content-Type", "application/json")
// 发送请求
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Printf("Error sending request: %v\n", err)
return
}
defer resp.Body.Close()
// 读取响应
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Printf("Error reading response body: %v\n", err)
return
}
// 解析JSON-RPC响应
var rpcResponse JSONRPCResponse
if err := json.Unmarshal(body, &rpcResponse); err != nil {
fmt.Printf("Error unmarshaling response: %v\n", err)
return
}
if rpcResponse.Error != nil {
fmt.Printf("RPC Error: Code %d, Message: %s\n", rpcResponse.Error.Code, rpcResponse.Error.Message)
return
}
var blockCount float64 // Bitcoin RPC often returns numbers as float6 
