解决Sqoop从PostgreSQL拉取数据时报TCP/IP连接的问题
在使用Sqoop从PostgreSQL进行数据迁移时，经常会遇到TCP/IP连接相关的错误，这类问题通常和数据库服务配置、网络权限、连接参数有关。下面我们将逐一分析常见原因并给出对应的解决步骤。
问题现象
执行Sqoop导出或导入命令时，控制台可能出现类似以下的错误信息：
Connection refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.
常见原因及解决方法
1. PostgreSQL服务未开启TCP/IP监听
PostgreSQL默认可能只监听本地回环地址，未开放外部TCP/IP连接，需要修改配置文件开启监听。
首先找到PostgreSQL的配置文件postgresql.conf，通常位于/etc/postgresql/版本/main/或者PostgreSQL安装目录的data文件夹下。修改以下配置项：
# 将监听地址改为所有网络接口，或者指定需要开放的IP listen_addresses = '*' # 确认端口号，默认是5432，若有修改需要记录 port = 5432
修改完成后重启PostgreSQL服务使配置生效：
# Ubuntu/Debian系统 sudo systemctl restart postgresql # CentOS/RHEL系统 sudo systemctl restart postgresql-版本号
2. 未配置客户端IP访问权限
即使开启了TCP/IP监听，PostgreSQL的pg_hba.conf文件也会控制客户端的访问权限，需要添加对应规则允许Sqoop所在的客户端IP连接。
找到pg_hba.conf文件，和postgresql.conf在同一目录，在文件末尾添加如下规则：
# 允许所有IP使用密码认证连接所有数据库，生产环境可缩小IP范围 host all all 0.0.0.0/0 md5 # 如果是IPv6环境还需要添加 host all all ::/0 md5
修改后同样需要重启PostgreSQL服务。
3. 连接参数填写错误
Sqoop命令中的连接参数错误也会导致TCP/IP连接失败，需要核对以下参数：
连接地址：确认
--connect参数中的IP和端口正确，格式为jdbc:postgresql://IP:端口/数据库名，例如jdbc:postgresql://192.168.1.100:5432/testdb用户名密码：确认
--username和--password对应的数据库账号有权限访问目标数据库防火墙规则：检查PostgreSQL所在服务器的防火墙是否开放了对应端口，若使用云服务器还需要检查安全组规则
正确的Sqoop导入命令示例：
sqoop import \ --connect jdbc:postgresql://192.168.1.100:5432/testdb \ --username postgres \ --password 123456 \ --table user_info \ --target-dir /user/hive/warehouse/user_info \ --fields-terminated-by '\t' \ -m 1
4. 网络连通性问题
可以在Sqoop所在的客户端机器上，使用telnet或者nc命令测试到PostgreSQL服务的网络连通性：
# 测试端口是否可达，能连通会显示连接成功 telnet 192.168.1.100 5432 # 或者使用nc命令 nc -zv 192.168.1.100 5432
如果无法连通，需要排查网络路由、防火墙、安全组等配置，确保客户端到PostgreSQL服务器的对应端口网络通畅。
验证方法
修改配置后，可以先使用PostgreSQL客户端工具在Sqoop所在机器测试连接，确认数据库可以正常访问后再执行Sqoop命令：
# 使用psql客户端测试连接 psql -h 192.168.1.100 -p 5432 -U postgres -d testdb
如果能够成功进入psql交互界面，说明TCP/IP连接已经正常，此时再执行Sqoop命令即可避免连接错误。
注意事项
生产环境中不建议将pg_hba.conf的访问规则设置为允许所有IP，应该根据实际需求缩小客户端IP范围，同时使用强密码策略，避免数据库暴露安全风险。如果需要查看PostgreSQL的连接日志，可以查看postgresql.conf中log_directory配置的目录下的日志文件，日志中会记录更详细的连接失败原因。
Sqoop连接PostgreSQL TCPIP连接失败 PostgreSQL配置 Sqoop网络问题 pg_hba.conf配置