“address already in use”错误表明端口被占或监听地址配置错误,需用lsof(Linux/macOS)或netstat+tasklist(Windows)查PID并终止冲突进程;Revel默认监听0.0.0.0:9000,必须同时显式指定-p和-addr参数才生效。

Revel 启动失败,八成是端口被占或监听地址配置错——不是框架坏了,是它根本没绑上端口。
看到 “address already in use” 就该查进程,不是改代码
这个错误来自操作系统内核,net/http 在调用 ListenAndServe 时被拒绝,说明 :9000(或你指定的端口)已被其他进程独占绑定。别急着改 app.conf 或重装 Revel。
- Linux/macOS:运行
sudo lsof -iTCP:9000 -sTCP:LISTEN,看输出里有没有非revel的进程名(如node、python、php-fpm) - Windows:先跑
netstat -ano | findstr :9000拿 PID,再用tasklist | findstr <pid></pid>确认进程;若无结果,试试 PowerShell 命令Get-NetTCPConnection -LocalPort 9000 | Get-Process - 特别注意:Revel 默认监听
0.0.0.0:9000,但只要任意一个进程绑定了[::]:9000、127.0.0.1:9000或192.168.x.x:9000,都会冲突——必须查全所有地址族
只写 -addr 127.0.0.1 不生效?因为没配端口
Revel 命令行参数有隐式优先级:-p 控制端口,-addr 控制 IP,二者必须同时显式给出才完整生效。只写 revel run -a myapp -addr 127.0.0.1,Revel 仍用默认端口 9000,此时若 127.0.0.1:9000 被占,就直接失败。
- 正确写法永远是:
revel run -a myapp -p 8080 -addr 127.0.0.1 - 容器或 WSL2 场景下,
-addr必须为0.0.0.0,否则即使端口映射了,请求也进不来 - 如果用末尾数字方式(如
revel run myapp dev 8080),它只覆盖端口,http.addr仍按app.conf解析——若配置文件里没设http.addr,就回退到默认的0.0.0.0
app.conf 里的 http.port 为啥不生效
Revel 加载配置顺序是:命令行 > 环境变量 > app.conf。如果你在终端里执行了 revel run myapp dev 9000,那 app.conf 里的 http.port 就完全被忽略。
- 检查控制台启动日志:是否出现
Running on http://127.0.0.1:8080?若显示http://0.0.0.0:8080,说明http.addr没生效,常见原因是拼错键名(比如写成http.address)、被注释、或放在了错误 section(如[prod]里却用dev模式启动) - 验证真实绑定:Linux/macOS 下执行
lsof -n -iTCP:8080 | grep LISTEN,输出中应含127.0.0.1:8080,而非*:8080或[::]:8080 - 生产环境严禁留空
http.addr或设为0.0.0.0,必须明确写http.addr = "127.0.0.1"
启动后 localhost 打不开?先确认是不是监听对了地址
Revel 默认监听 0.0.0.0:9000,但 Windows 防火墙、Docker 端口映射缺失、WSL2 网络隔离都可能导致连不上 localhost。更隐蔽的问题是:你以为它在听 127.0.0.1,其实它在听 0.0.0.0,而你的防火墙规则只放行了回环流量。
- 启动后立刻用
curl -v http://127.0.0.1:9000测试,比浏览器更干净(绕过 DNS、缓存、HTTPS 自动跳转) - WSL2 用户必须监听
0.0.0.0,且 Windows 防火墙要放行对应端口;若仍不通,检查 WSL2 的/etc/resolv.conf是否被篡改 - 容器场景下,
docker run -p 9000:9000后,Revel 进程内部必须监听0.0.0.0:9000,监听127.0.0.1是无效的
最常被忽略的点:端口占用排查只查 IPv4,漏了 IPv6 的 [::]:9000;还有人改了 app.conf 却忘了删掉命令行里的 -p 参数,导致配置被静默覆盖。动手前,先看一眼启动日志里写的到底是哪个地址和端口。


















