Docker容器内Golang服务器启动失败：无法识别主机地址

错误根源 #

你的错误信息里明确显示lookup = 127.0.0.1——这里的多余等号是核心问题。Go的ListenAndServe会把传入的地址字符串当成域名解析，而带=的字符串不是合法IP或域名，所以触发了DNS lookup失败。

排查与修复步骤 #

1. 检查代码中的地址配置
   大概率是代码里拼接或读取监听地址时引入了多余的=，比如：

   // 错误示例：错误拼接了等号
   addr := "=" + os.Getenv("SERVER_PORT")
   http.ListenAndServe(addr, nil)
   

   或者读取环境变量时，环境变量本身的值就带=（比如ADDR==0.0.0.0:8080）。

   修正后的正确写法：

   package main
   
   import (
       "log"
       "net/http"
       "os"
   )
   
   func main() {
       // 读取环境变量，默认用0.0.0.0:8080（容器内必须监听0.0.0.0才能外部访问）
       addr := os.Getenv("SERVER_ADDR")
       if addr == "" {
           addr = "0.0.0.0:8080"
       }
       // 打印地址用于调试
       log.Printf("Starting server on %s", addr)
       log.Fatal(http.ListenAndServe(addr, nil))
   }
   

2. 检查Docker运行命令/环境变量配置
   确保传递环境变量时没有多打等号，比如：

   • 错误写法：docker run -e SERVER_ADDR==0.0.0.0:8080 your-image
   • 正确写法：docker run -e SERVER_ADDR=0.0.0.0:8080 -p 8080:8080 your-image

3. 验证调试
   在代码中添加监听地址的打印日志，构建镜像后启动容器，查看日志确认地址格式是否正确。如果日志里显示Starting server on =127.0.0.1:8080，就说明地址确实带了多余等号，顺着这个线索找代码或环境变量的问题即可。

额外说明 #

容器内必须监听0.0.0.0:8080才能让宿主机或外部访问，127.0.0.1仅容器内部可访问，但你的问题本质不是这个，而是地址格式错误导致的DNS解析失败。

内容的提问来源于stack exchange，提问作者QuickDzen