本文旨在解决Go语言`net/rpc`包在使用HTTP模式时常见的“404 Not Found”错误。核心问题在于服务器端缺少对RPC HTTP路径的正确注册。我们将详细阐述`rpc.HandleHTTP()`的作用，解释其如何将RPC服务与默认HTTP多路复用器集成，并提供修正后的代码示例，确保客户端能够成功连接并调用RPC方法。
Go RPC HTTP模式配置详解
Go语言的net/rpc包提供了一种方便的方式来实现远程过程调用。它支持两种主要的通信模式：基于Gob编码的TCP连接，以及基于HTTP协议的连接。当开发者尝试使用rpc.DialHTTP客户端连接一个通过http.Serve启动的RPC服务器时，一个常见的错误是客户端收到“404 Not Found”响应。这通常表明服务器未能正确地将RPC服务暴露在HTTP路径上。
问题根源分析：404 Not Found
当使用net/rpc包配合HTTP协议时，rpc.DialHTTP客户端默认会尝试连接服务器的特定HTTP路径来处理RPC请求。具体来说，它会向/debug/rpc路径发送RPC请求，并可能访问/debug/requests路径以获取调试信息。
如果服务器端仅仅使用http.Serve(l, nil)来启动HTTP服务，而没有明确地注册RPC处理函数到HTTP多路复用器（http.DefaultServeMux）上，那么当客户端尝试访问/debug/rpc时，服务器将无法找到对应的处理程序，从而返回“404 Not Found”错误。http.Serve(l, nil)意味着使用默认的HTTP多路复用器，但默认情况下，这个多路复用器并不知道如何处理RPC请求。
立即学习“go语言免费学习笔记（深入）”；
解决方案：使用 rpc.HandleHTTP()
解决这个问题的关键在于调用rpc.HandleHTTP()。这个函数的作用是将net/rpc包内置的HTTP RPC处理程序注册到Go标准库的http.DefaultServeMux（默认HTTP多路复用器）上。一旦调用了rpc.HandleHTTP()，http.DefaultServeMux就会知道如何处理来自/debug/rpc和/debug/requests路径的请求，从而正确地将它们路由到RPC服务。
修正后的服务器端代码示例：
package main
import (
"flag"
"log"
"net"
"net/http"
"net/rpc"
)
// Chat 类型，用于注册RPC服务
type Chat string
// Msg 方法，RPC服务的一个具体方法
func (t *Chat) Msg(msg string, bytes *int) error {
*bytes = len(msg)
log.Printf("Received message: '%s', length: %d\n", msg, *bytes)
return nil
}
func main() {
serverAddr := flag.String("server", "127.0.0.1:8082", "Server address and port")
clientMode := flag.Bool("c", false, "Run as client")
flag.Parse()
if !(*clientMode) {
// 服务器端逻辑
chat := new(Chat)
// 1. 注册RPC服务实例
rpc.Register(chat)
// 2. 注册RPC的HTTP处理函数到默认HTTP多路复用器
rpc.HandleHTTP() // 这是关键的一步！
l, e := net.Listen("tcp", *serverAddr)
if e != nil {
log.Fatal("listen error:", e)
}
log.Printf("RPC Server listening on %s\n", l.Addr().String())
// 3. 启动HTTP服务器来处理RPC请求
// http.Serve 会使用 http.DefaultServeMux 来处理请求
http.Serve(l, nil) // nil 表示使用 http.DefaultServeMux
} else {
// 客户端逻辑
log.Printf("Client connecting to %s\n", *serverAddr)
// 客户端使用 rpc.DialHTTP 连接服务器
client, err := rpc.DialHTTP("tcp", *serverAddr)
if err != nil {
log.Fatal("dialing error: ", err)
}
defer client.Close()
var reply int
err = client.Call("Chat.Msg", "Hello RPC World!", &reply)
if err != nil {
log.Fatal("chat error:", err)
}
log.Printf("Msg: returned %d (length of message)\n", reply)
}
}运行与测试：
-
启动服务器：
go run your_app.go -server=127.0.0.1:8082
服务器将输出类似 RPC Server listening on 127.0.0.1:8082 的信息。
-
启动客户端：
go run your_app.go -c -server=127.0.0.1:8082
客户端将输出类似 Msg: returned 16 (length of message) 的信息，表明RPC调用成功。服务器端也会打印接收到的消息。
关于 go rpc.Accept(l) 的说明
在原始代码中，服务器端除了http.Serve(l, nil)之外，还使用了go rpc.Accept(l)。当使用rpc.DialHTTP和http.Serve组合时，rpc.Accept(l)是不必要且多余的。
- rpc.Accept(l) 用于处理基于Gob编码的原始TCP RPC连接。它会在一个新的goroutine中监听并接受来自net.Listener的连接，然后为每个连接启动一个goroutine来处理RPC请求。
- http.Serve(l, nil) 则负责监听并接受来自net.Listener的HTTP连接。它会为每个HTTP连接启动一个goroutine，并根据HTTP请求的路径，通过http.DefaultServeMux来查找并调用相应的HTTP处理函数（例如，由rpc.HandleHTTP()注册的RPC处理函数）。
因此，当目标是建立HTTP RPC连接时，http.Serve已经包含了连接管理和请求分发的功能，rpc.Accept的存在反而可能导致端口冲突或行为不一致。移除go rpc.Accept(l)是正确的做法。
总结
在使用Go语言的net/rpc包实现基于HTTP的RPC服务时，务必遵循以下步骤：
- 使用rpc.Register()注册你的RPC服务实例。
- 调用rpc.HandleHTTP()将RPC处理程序注册到默认的HTTP多路复用器。
- 使用http.Serve(listener, nil)启动HTTP服务器，它将利用已注册的RPC处理程序来响应来自rpc.DialHTTP客户端的请求。
遵循这些步骤将确保你的Go RPC HTTP服务器能够正确响应客户端请求，避免常见的“404 Not Found”错误。
