Intershop数据库迁移遇‘Address already in use’错误的修复咨询

1. 排查端口占用情况 #

• 先明确迁移过程中尝试使用的目标端口（通常是数据库连接端口、迁移工具内部服务端口）
• 用系统命令定位占用进程：
  • Windows：netstat -ano | findstr :<端口号>，找到对应PID后在任务管理器终止进程
  • Linux/macOS：lsof -i :<端口号> 或 netstat -tulpn | grep :<端口号>，执行kill -9 <PID>结束占用进程

2. 检查迁移配置文件的端口设置 #

• 核对AddService和Addconfiguration属性文件，查找类似database.port、migration.service.port的配置项，确认是否与现有服务端口重叠，修改为未被占用的端口
• 重新检查orm属性文件，确保多个数据源配置未使用同一端口，避免内部端口冲突

3. 停止冲突的Intershop服务 #

• 迁移前彻底关闭Intershop应用服务器（如Tomcat、WildFly），这类服务可能占用数据库连接端口或内部通信端口，导致迁移工具无法绑定
• 检查Intershop核心配置文件（如server.properties）中的端口设置，确认与迁移工具使用的端口无重叠

4. 配置迁移工具使用随机端口 #

• 若不确定可用端口，可在Addconfiguration属性文件中设置服务端口为0，让系统自动分配空闲端口：

  migration.service.port=0
  

  注意：数据库连接端口不能设为0，需确认数据库服务端口未被占用，或修改迁移配置中的数据库连接URL端口

5. 排查防火墙/安全软件拦截 #

• 临时关闭防火墙或安全软件，确认是否是这类工具占用端口或阻止迁移工具绑定端口
• 确保迁移工具所需端口已在防火墙规则中被允许通过

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