Listener接口核心契约是仅需实现Accept()、Close()和Addr()三个方法，只要能返回满足net.Conn接口的连接对象并提供稳定地址即可，不依赖具体网络协议或端口绑定。
Listener 接口的核心契约是什么
Go 的 net.Listener 接口只要求实现三个方法：Accept()、Close() 和 Addr()。它不关心底层是 TCP、Unix socket 还是内存通道，只约定「谁来连接、怎么暴露地址、如何关闭」。这意味着只要你能返回一个满足 net.Conn 接口的连接对象，并提供稳定地址，就可作为合法 Listener 使用。
常见误判是认为必须绑定端口或调用 net.Listen() 才算 Listener —— 实际上，http.Serve()、grpc.Server.Serve() 等所有接受 net.Listener 参数的函数，都只依赖这三个方法的行为一致性。
如何用 channel 实现一个内存级 Listener
适合测试、本地 IPC 或 mock 场景：不走系统网络栈，纯 Go 协程间通信。关键在于把「等待连接」转为「从 channel 接收 Conn」。
type ChanListener struct {
addr net.Addr
conns chan net.Conn
closed chan struct{}
}
<p>func (l *ChanListener) Accept() (net.Conn, error) {
select {
case conn := <-l.conns:
return conn, nil
case <-l.closed:
return nil, errors.New("listener closed")
}
}</p><p>func (l *ChanListener) Close() error {
close(l.closed)
return nil
}</p><p>func (l *ChanListener) Addr() net.Addr { return l.addr }
立即学习“go语言免费学习笔记（深入）”；
-
connschannel 必须是带缓冲的（如make(chan net.Conn, 16)），否则Accept()会永久阻塞，无法响应Close() -
Addr()返回的net.Addr不必真实存在，但需满足接口；常用&net.TCPAddr{IP: net.IPv4(127, 0, 0, 1), Port: 9999}或自定义结构体 - 调用方（如
http.Serve(l, mux)）会在单独 goroutine 中反复调用Accept()，所以你的conns需要由外部主动推送连接（比如另一个 goroutine 调用l.conns <- myConn）
Accept() 返回的 Conn 必须满足什么条件
不是任意实现了 Read()/Write() 的类型都能当 net.Conn —— 它还要求：
-
LocalAddr()和RemoteAddr()都不能返回nil，哪怕只是占位符（如&net.TCPAddr{Port: 0}） -
SetDeadline()、SetReadDeadline()、SetWriteDeadline()必须可调用（即使内部不做任何事），否则http.Server等标准库组件会 panic - 若 Conn 可能被并发读写（例如被多个 handler goroutine 同时使用），需自行加锁或确保底层 buffer 线程安全
最简可行的 mock Conn 示例：
type MockConn struct {
r io.Reader
w io.Writer
}
<p>func (c <em>MockConn) Read(b []byte) (int, error) { return c.r.Read(b) }
func (c </em>MockConn) Write(b []byte) (int, error) { return c.w.Write(b) }
func (c <em>MockConn) Close() error { return nil }
func (c </em>MockConn) LocalAddr() net.Addr { return &net.TCPAddr{Port: 0} }
func (c <em>MockConn) RemoteAddr() net.Addr { return &net.TCPAddr{Port: 0} }
func (c </em>MockConn) SetDeadline(t time.Time) error { return nil }
func (c <em>MockConn) SetReadDeadline(t time.Time) error { return nil }
func (c </em>MockConn) SetWriteDeadline(t time.Time) error { return nil }
为什么 Serve() 有时卡住不动
根本原因通常是 Accept() 没有按预期返回，或者返回了非法 Conn。典型表现：服务启动无报错，但请求完全无响应，http.Server.Serve() 日志里也看不到连接日志。
- 检查
Accept()是否在某个条件下永远阻塞（比如 channel 无 sender、互斥锁未释放、或用了无缓冲 channel 且没人发） - 确认返回的
net.Conn的Read()方法是否立即返回io.EOF或io.ErrUnexpectedEOF—— 这会让http.Server认为连接异常中断，直接丢弃 - 如果 Listener 是为 gRPC 设计的，注意 gRPC 的
Server.Serve()会对每个 Conn 调用SetReadDeadline()并期望它生效；若你的 Conn 直接返回nil错误，会导致 panic
调试建议：在 Accept() 返回前加日志，打印返回值和错误；再在 Conn 的 Read() 开头加日志，确认是否真的被调用。
