beego 默认读取 conf/app.conf 中的 httpport 配置生效，无需改代码或调用 api；需确保其位于当前 runmode 对应 section 内、为整数且无引号，并配合 httpaddr 使用。
conf/app.conf 里改 httpport 就生效
Beego 默认读取 conf/app.conf，只要在该文件中设置 httpport，启动时就会监听对应端口。不需要改代码、也不需要调用 API。
常见错误现象：改了 main.go 里 web.Run() 的参数，或者试图用 beego.BConfig.Listen.HTTPPort = 5000 赋值——这些操作在 Beego v2 中无效，因为监听配置已在初始化阶段锁定，运行时修改不生效。
-
httpport值必须是整数（如httpport = 5000），不能带引号 - 若同时设置了
httpaddr（如httpaddr = "0.0.0.0"），端口才真正对外可访问；只改端口但没配地址，可能仍绑定在127.0.0.1 - 部署到云平台（如某些 PaaS）时，平台可能强制指定端口（如只允许
5000），此时必须同步修改httpport = 5000，否则启动失败或被拒绝监听
多环境配置下要写对 section
如果你用了 [dev]、[prod] 等 section 分隔配置，httpport 必须放在当前 runmode 对应的 section 下，否则会被忽略。
例如 conf/app.conf 写成这样：
runmode = prod [dev] httpport = 8080 [prod] httpport = 5000
那么只有 [prod] 下的 httpport = 5000 生效。容易踩的坑是把 httpport 写在全局区（section 外），它会被各 section 中同名配置覆盖。
- 用
beego.BConfig.Listen.HTTPPort查看实际加载值，确认是否符合预期 - Beego 不区分配置项大小写，但 section 名严格区分大小写：
[PROD]和[prod]是不同环境 - 如果
runmode没显式设置，默认为dev，所以全局写的httpport在 dev 模式下也无效
别在代码里硬编码端口，除非你明确要覆盖配置
Beego v2 支持通过 web.RunWithOptions 传入 web.ListenOptions 强制指定端口，但这会绕过所有配置文件逻辑，属于非常规操作。
示例：
web.RunWithOptions(&web.ListenOptions{
Port: 5000,
})
这种写法的问题在于：一旦上线，所有环境都固定为 5000，无法靠 app.conf 切换；且和 httpaddr、EnableHTTPS 等其他监听参数不自动协同。
- 仅建议用于测试脚本或 CI 环境中临时覆盖
- 生产环境务必使用
conf/app.conf配置，避免部署时端口不一致 - 如果用了 bee 工具启动（
bee run），它会自动读取runmode并加载对应 section，无需额外干预
启动后验证端口是否真被监听
改完配置不等于端口就通了。常见干扰因素包括：防火墙、SELinux、宿主机网络策略、Docker 端口映射未设置。
最直接的验证方式是启动后执行：
lsof -i :5000
或在 Go 代码里加一行日志：
fmt.Printf("Server listening on %s:%d\n", beego.BConfig.Listen.HTTPAddr, beego.BConfig.Listen.HTTPPort)
- 注意
HTTPAddr默认是空字符串，此时 Beego 绑定到0.0.0.0；设为"127.0.0.1"则仅本地可访问 - 某些容器平台要求显式声明
EXPOSE 5000，否则健康检查失败 - 如果看到
bind: address already in use错误，说明端口被占，不是配置没生效，而是系统层冲突
runmode、section、httpaddr 三者是否协同一致。
