Docker容器中Odoo 15报错Errno 98端口被占用的解决求助

问题根源 #

你遇到的问题本质是：容器内已有一个正常运行的Odoo实例占用了默认端口（通常是8069），当你手动执行odoo命令（比如更新模块、查看输出）时，这条命令会尝试启动全新的Odoo进程，而新进程默认会使用和现有实例相同的端口，最终导致端口冲突报错。浏览器能正常访问是因为原有容器实例已经在监听端口，不受新命令的冲突影响。

解决方案 #

方案1：执行命令时禁用HTTP服务（仅运行核心逻辑） #

当你需要执行模块更新、数据库操作这类无需启动新服务的命令时，直接添加--no-xmlrpc参数，让Odoo只执行命令逻辑而不监听端口：

# 先进入运行中的Odoo容器（替换成你的容器名或ID）
docker exec -it <your-odoo-container-id/name> bash
# 执行模块更新命令，示例：更新sale模块
odoo -d <your-db-name> -u sale --no-xmlrpc

如果需要查看详细日志，可追加--log-level=info调整日志输出级别。

方案2：临时指定新端口执行命令 #

如果必须启动HTTP服务做临时调试，可以在执行命令时指定未被占用的端口，避开现有实例的端口：

# 进入容器后执行，指定临时端口（比如8070）
odoo -d <your-db-name> --xmlrpc-port=8070

注意：此端口仅在容器内部使用，无需映射到宿主机，避免和外部服务冲突。

方案3：确认容器内端口占用情况 #

若不确定当前端口占用状态，可进入容器后执行以下命令排查：

# 查看容器内Odoo进程监听的端口
netstat -tulpn | grep odoo

通过输出结果明确现有实例的占用端口，确保执行命令时避开该端口。

为什么之前的尝试无效？ #

1. 修改配置文件添加xmlrpc_port = 7654：该配置会让容器内的主Odoo实例改用7654端口，但你未同步修改docker-compose.yml中的端口映射规则（宿主机端口→容器7654），导致Web界面无法访问。同时，此修改针对的是主实例，和手动执行命令时的新进程端口冲突无关。
2. 修改docker-compose.yml端口配置：这仅改变了宿主机与容器的端口映射关系，容器内部的Odoo主实例依然监听原有端口（如8069），所以手动执行命令时仍会和主实例端口冲突。

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