Connection timeout 오류 원인과 확인 방법|IT 운영자가 먼저 봐야 할 네트워크·서버 문제

2026. 6. 18. 13:55IT 실무노트

Connection timeout 오류가 발생했을 때 IT 운영자가 확인해야 할 항목을 정리했습니다. 출발지와 목적지, 포트, 방화벽, DNS, 서버 상태, 서비스 상태, API 응답 지연, SFTP 접속, DB 연결, Timeout 설정값까지 실무 기준으로 설명합니다.

 

IT 운영 업무를 하다 보면 API 연동, SFTP 접속, DB 연결, 웹 시스템 접속 중에 Connection timeout 오류가 발생하는 경우가 있습니다.

사용자나 외부 업체는 보통 이렇게 문의합니다.

“접속이 한참 걸리다가 실패합니다.”
“API 호출이 Timeout으로 떨어집니다.”
“SFTP 연결이 되지 않고 시간이 초과됩니다.”
“서버가 응답하지 않는 것 같습니다.”
“방화벽은 열려 있다고 하는데 계속 Timeout이 납니다.”

Connection timeout 오류는 단순히 “서버가 죽었다”는 의미로만 보면 안 됩니다.

서버가 정말 응답하지 않는 경우도 있지만, 네트워크 지연, 방화벽 차단, 포트 미응답, 상대 시스템 부하, DNS 문제, API 응답 지연 등 여러 원인이 있을 수 있습니다.

IT 운영직이나 SM팀 업무에서는 Timeout 오류가 발생했을 때 어느 구간에서 응답이 지연되는지를 확인하는 것이 중요합니다.

이번 글에서는 Connection timeout 오류의 의미와 IT 운영자가 장애 대응 시 확인해야 할 항목을 실무 기준으로 정리해보겠습니다.

Connection timeout 오류란?

Connection timeout은 요청을 보냈지만 정해진 시간 안에 응답을 받지 못했을 때 발생하는 오류입니다.

쉽게 말하면 다음과 같습니다.

“접속을 시도했지만, 일정 시간 동안 응답이 없어 실패했습니다.”

예를 들어 우리 시스템이 외부 API 서버로 요청을 보냈는데 상대 서버가 응답하지 않거나, 중간 네트워크에서 통신이 지연되면 Timeout이 발생할 수 있습니다.

SFTP 접속 시에도 서버에 연결을 시도했지만 일정 시간 안에 연결이 완료되지 않으면 Timeout 오류가 발생할 수 있습니다.

DB 연결에서도 애플리케이션 서버가 DB 서버에 접속하려고 했지만 응답을 받지 못하면 Connection timeout이 발생할 수 있습니다.

즉, Timeout은 주로 응답 지연 또는 통신 실패와 관련된 오류입니다.

Timeout 오류가 발생하는 대표적인 상황

Connection timeout 오류는 여러 상황에서 발생할 수 있습니다.

대표적인 사례는 다음과 같습니다.

  • 외부 API 서버 응답 지연
  • SFTP 서버 접속 지연
  • DB 서버 연결 지연
  • 방화벽 정책 누락
  • 특정 포트 차단
  • 네트워크 회선 지연
  • DNS 해석 지연
  • 상대 시스템 부하
  • 서버는 켜져 있지만 서비스가 응답하지 않음
  • VPN 연결 불안정
  • 로드밸런서 또는 프록시 문제
  • 요청 처리 시간이 너무 오래 걸림
  • Timeout 설정 시간이 너무 짧음

운영자 입장에서는 Timeout이 발생했을 때 “어디가 문제인지”를 바로 단정하기 어렵습니다.

그래서 요청 흐름을 기준으로 하나씩 확인해야 합니다.

Connection timeout과 Connection refused 차이

Timeout 오류는 Connection refused와도 자주 헷갈립니다.

둘 다 접속이 실패한 것처럼 보이지만 의미가 다릅니다.

구분Connection timeoutConnection refused

의미 일정 시간 동안 응답이 없음 연결 요청이 거부됨
주요 원인 네트워크 지연, 방화벽 차단, 서버 무응답 서비스 미기동, 포트 미오픈, 서버가 연결 거부
느낌 기다리다가 실패 즉시 거부되는 경우가 많음
확인 방향 네트워크 경로, 방화벽, 응답 지연 확인 포트, 서비스 기동, 설정 확인

쉽게 말하면 Timeout은 “문을 두드렸는데 아무 대답이 없는 상태”에 가깝고, Connection refused는 “문은 찾았지만 들어오지 말라고 거부당한 상태”에 가깝습니다.

운영자는 오류 메시지를 보고 확인 방향을 다르게 잡아야 합니다.

1. 오류 발생 구간 확인

Timeout 오류가 발생하면 가장 먼저 어느 구간에서 발생했는지 확인해야 합니다.

같은 Timeout이라도 발생 위치에 따라 원인이 다릅니다.

확인해야 할 구간은 다음과 같습니다.

  • 사용자 PC → 웹 시스템
  • 웹서버 → WAS
  • WAS → DB 서버
  • 내부 서버 → 외부 API 서버
  • 외부 업체 서버 → 우리 SFTP 서버
  • 배치 서버 → 외부 시스템
  • VPN 사용자 → 내부 시스템
  • 모니터링 서버 → 대상 서버

예를 들어 사용자가 웹 화면 접속 시 Timeout을 겪는 것과, 배치 서버가 외부 API 호출 시 Timeout을 겪는 것은 확인 방향이 다릅니다.

운영자는 먼저 “누가 누구에게 접속하다가 Timeout이 났는지”를 정리해야 합니다.

2. 특정 사용자 문제인지 전체 문제인지 확인

Timeout 오류가 발생하면 영향 범위를 확인해야 합니다.

특정 사용자 한 명만 발생하는지, 전체 사용자에게 발생하는지에 따라 원인이 달라질 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 특정 사용자만 발생하는지
  • 특정 PC에서만 발생하는지
  • 특정 네트워크 환경에서만 발생하는지
  • 사내망과 외부망 차이가 있는지
  • VPN 사용자에게만 발생하는지
  • 전체 사용자에게 동시에 발생하는지
  • 특정 시간대에만 발생하는지

특정 사용자만 발생한다면 사용자 PC, 브라우저, VPN, 로컬 네트워크 문제일 수 있습니다.

전체 사용자에게 발생한다면 서버, 네트워크 장비, 방화벽, DNS, 서비스 장애 가능성을 더 크게 봐야 합니다.

3. 서버가 살아 있는지 확인

Timeout이 발생하면 대상 서버가 정상 상태인지 확인해야 합니다.

서버가 내려가 있거나 응답하지 않는 상태라면 접속 요청이 시간 초과될 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 서버 전원이 켜져 있는지
  • 서버 OS가 정상인지
  • CPU 사용률이 과도하게 높지 않은지
  • 메모리 사용률이 높은지
  • 디스크 사용률이 가득 찼는지
  • 네트워크 인터페이스가 정상인지
  • 서버 재기동 이력이 있는지
  • 최근 작업이나 패치가 있었는지

서버는 켜져 있어도 리소스가 과도하게 높으면 응답이 늦어질 수 있습니다.

특히 CPU나 메모리가 과도하게 사용 중이면 요청을 제때 처리하지 못해 Timeout이 발생할 수 있습니다.

4. 서비스가 정상 기동 중인지 확인

서버가 켜져 있다고 해서 서비스가 정상이라는 뜻은 아닙니다.

웹서버, WAS, DB, SFTP 서비스가 내려가 있거나 비정상 상태라면 접속이 실패할 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 웹서버가 기동 중인지
  • WAS가 기동 중인지
  • DB 서비스가 정상인지
  • SFTP 서비스가 정상인지
  • API 서비스가 정상 응답하는지
  • 배치 서비스가 정상 동작 중인지
  • 서비스 포트가 LISTEN 상태인지

예를 들어 서버 OS는 정상인데 WAS가 내려가 있으면 웹 화면 접속이 실패할 수 있습니다.

DB 서버는 켜져 있지만 DB 리스너가 내려가 있으면 애플리케이션에서 DB 연결 Timeout이 발생할 수 있습니다.

운영자는 서버 상태와 서비스 상태를 구분해서 봐야 합니다.

5. 포트 접속 여부 확인

Timeout 오류에서 중요한 확인 항목 중 하나는 포트 접속 여부입니다.

특정 서버의 특정 포트로 접속이 가능한지 확인해야 합니다.

예를 들어 외부 API가 HTTPS라면 보통 443 포트를 확인합니다.

telnet api.example.com 443

SFTP라면 22번 포트를 확인합니다.

telnet sftp.example.com 22

Windows PowerShell에서는 아래처럼 확인할 수 있습니다.

Test-NetConnection api.example.com -Port 443

포트 접속이 실패하면 방화벽, 네트워크 경로, 서비스 미기동, 포트 차단 문제를 의심할 수 있습니다.

반대로 포트 접속은 되는데 업무 처리가 Timeout이라면 프로그램 처리 지연, API 응답 지연, DB 쿼리 지연 등 애플리케이션 영역도 확인해야 합니다.

6. 방화벽 허용 여부 확인

Timeout 오류는 방화벽 정책 때문에 발생할 수 있습니다.

방화벽에서 통신을 차단하거나 응답을 드롭하면 접속 요청이 대기하다가 Timeout으로 실패할 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 출발지 IP
  • 목적지 IP 또는 도메인
  • 목적지 포트
  • 프로토콜
  • Inbound 또는 Outbound 방향
  • 방화벽 정책 등록 여부
  • 최근 방화벽 정책 변경 여부
  • 서버 이전으로 IP가 변경되었는지
  • 운영/테스트 환경을 혼동하지 않았는지

예를 들어 우리 서버가 외부 API를 호출해야 한다면, 우리 서버 IP에서 외부 API 서버 443 포트로 나가는 통신이 허용되어야 합니다.

외부 업체가 우리 SFTP 서버로 접속해야 한다면, 외부 업체 IP에서 우리 SFTP 서버 22번 포트로 들어오는 통신이 허용되어야 합니다.

방화벽 요청 정보가 잘못되면 방화벽을 열었다고 해도 실제 통신은 되지 않을 수 있습니다.

7. DNS 확인

도메인으로 접속하는 시스템이라면 DNS 확인도 필요합니다.

도메인이 잘못된 IP를 바라보고 있거나, DNS 해석이 되지 않으면 Timeout처럼 보이는 접속 실패가 발생할 수 있습니다.

확인할 때는 nslookup을 사용할 수 있습니다.

nslookup api.example.com

확인해야 할 항목은 다음과 같습니다.

  • 도메인이 정상적으로 IP로 해석되는지
  • 기대한 IP와 실제 조회된 IP가 일치하는지
  • 내부망과 외부망에서 조회 결과가 다른지
  • DNS 변경 후 반영이 완료되었는지
  • 특정 서버에서만 DNS 조회가 안 되는지
  • 도메인 오타가 없는지

특히 서버 이전이나 외부 API 주소 변경 후에는 DNS가 올바르게 반영되었는지 확인해야 합니다.

8. 상대 시스템 상태 확인

Timeout 오류는 우리 시스템 문제가 아니라 상대 시스템 문제일 수도 있습니다.

외부 API 서버나 SFTP 서버가 응답하지 않으면 우리 시스템에서는 Timeout으로 보일 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 상대 시스템 장애 공지가 있는지
  • 상대 시스템 서버가 정상인지
  • 상대 API 응답 시간이 지연되는지
  • 상대 SFTP 서비스가 정상인지
  • 상대 방화벽에서 우리 IP를 허용했는지
  • 상대 시스템에서 최근 배포나 작업이 있었는지
  • 다른 업체도 동일한 문제를 겪는지

외부 연동에서는 우리 쪽과 상대 쪽을 모두 확인해야 합니다.

우리 서버와 방화벽이 정상이어도 상대 시스템이 응답하지 않으면 Timeout이 발생할 수 있습니다.

9. 요청 처리 시간이 긴지 확인

Timeout은 네트워크 문제뿐 아니라 처리 시간이 너무 길어서 발생하기도 합니다.

예를 들어 API 요청은 정상적으로 상대 서버에 도착했지만, 상대 시스템이 데이터를 처리하는 데 오래 걸리면 응답 시간이 초과될 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 요청 데이터 건수가 너무 많은지
  • DB 쿼리가 오래 걸리는지
  • 외부 시스템 응답 시간이 긴지
  • 파일 크기가 너무 큰지
  • 배치 처리 시간이 길어진 것은 아닌지
  • 특정 시간대에 부하가 몰리는지
  • 평소보다 처리량이 증가했는지

예를 들어 평소 5초 안에 응답하던 API가 특정 시간대에 60초 이상 걸린다면 네트워크보다 처리 지연 문제일 수 있습니다.

운영자는 Timeout이 발생했을 때 응답 시간과 처리 건수도 함께 확인해야 합니다.

10. Timeout 설정값 확인

시스템에는 보통 Timeout 설정값이 있습니다.

예를 들어 10초 안에 응답이 없으면 실패 처리하도록 설정되어 있을 수 있습니다.

상대 시스템 응답이 평소보다 조금만 늦어져도 설정값이 짧으면 Timeout이 발생할 수 있습니다.

확인해야 할 항목은 다음과 같습니다.

  • 연결 Timeout 설정
  • 읽기 Timeout 설정
  • API 호출 Timeout 설정
  • DB 연결 Timeout 설정
  • SFTP 연결 Timeout 설정
  • 배치 처리 Timeout 설정
  • 프록시나 로드밸런서 Timeout 설정

단, Timeout 설정을 무조건 늘리는 것이 정답은 아닙니다.

설정을 늘리면 일시적으로 오류가 줄어들 수 있지만, 근본 원인인 응답 지연이나 처리 지연이 해결되지 않을 수 있습니다.

먼저 왜 응답이 늦어졌는지 확인해야 합니다.

API 호출 시 Timeout 확인 순서

API 호출에서 Timeout이 발생하면 아래 순서로 확인하면 좋습니다.

  1. API 호출 시간 확인
  2. 호출 서버 확인
  3. API URL과 도메인 확인
  4. nslookup으로 도메인 해석 확인
  5. 443 포트 접속 여부 확인
  6. 방화벽 허용 여부 확인
  7. 요청이 상대 시스템에 도착했는지 확인
  8. 상대 시스템 응답 로그 확인
  9. 요청 데이터 건수 확인
  10. API 응답 시간 확인
  11. Timeout 설정값 확인
  12. 재시도 여부와 중복 처리 가능성 확인

API Timeout은 재처리할 때 주의가 필요합니다.

요청은 상대 시스템에 도착했지만 응답만 늦어진 경우, 무조건 재전송하면 중복 처리될 수 있습니다.

따라서 재처리 전에는 상대 시스템 처리 여부를 확인해야 합니다.

SFTP 접속 시 Timeout 확인 순서

SFTP 접속에서 Timeout이 발생하면 아래 순서로 확인하면 좋습니다.

  1. 접속 대상 서버 확인
  2. 접속 IP 또는 도메인 확인
  3. 22번 포트 접속 여부 확인
  4. 방화벽 허용 여부 확인
  5. SFTP 서비스 기동 여부 확인
  6. 상대 IP 허용 여부 확인
  7. 계정 또는 키 파일 문제인지 확인
  8. 접속 로그 확인
  9. 파일 업로드 또는 다운로드 경로 확인
  10. 파일 크기와 전송 시간 확인

SFTP에서 포트 접속 자체가 안 되면 네트워크나 방화벽 문제 가능성이 큽니다.

포트 접속은 되는데 로그인 실패가 발생한다면 계정이나 인증 문제를 확인해야 합니다.

로그인 후 파일 전송 중 Timeout이 발생한다면 파일 크기, 네트워크 속도, 디스크 상태, 경로 권한을 확인해야 합니다.

DB 연결 시 Timeout 확인 순서

DB 연결에서 Timeout이 발생하면 애플리케이션 서버와 DB 서버 간 통신을 확인해야 합니다.

확인 순서는 다음과 같습니다.

  1. DB 서버 IP 또는 도메인 확인
  2. DB 포트 확인
  3. 애플리케이션 서버에서 DB 포트 접속 확인
  4. DB 서비스 또는 리스너 상태 확인
  5. DB 서버 리소스 확인
  6. DB 접속 계정 상태 확인
  7. DB 커넥션 풀 상태 확인
  8. 장시간 실행 중인 쿼리 확인
  9. DB 부하 시간대 확인
  10. 최근 DB 서버 작업 여부 확인

DB connection timeout은 네트워크 문제일 수도 있고 DB 부하 문제일 수도 있습니다.

포트 접속이 안 되면 네트워크나 방화벽을 봐야 하고, 포트 접속은 되지만 연결이 지연된다면 DB 상태와 커넥션 풀을 함께 확인해야 합니다.

로그에서 Timeout 확인하기

Timeout 오류가 발생하면 로그를 확인해야 합니다.

로그에서 확인할 항목은 다음과 같습니다.

  • 오류 발생 시간
  • 요청 URL
  • 요청 Method
  • 대상 IP 또는 도메인
  • 포트
  • 응답 시간
  • Timeout 설정값
  • 요청 데이터 건수
  • 재시도 여부
  • 오류 메시지
  • 처리 성공 여부

자주 보이는 메시지는 다음과 같습니다.

Connection timed out
Read timed out
SocketTimeoutException
ConnectTimeoutException
Request timeout
Gateway timeout
DB connection timeout
SFTP connection timeout

로그를 볼 때는 Timeout 메시지만 확인하지 말고, 발생 직전의 요청 정보와 처리 시간을 함께 봐야 합니다.

특히 반복 발생 여부와 특정 시간대 집중 여부를 확인하는 것이 중요합니다.

Timeout 오류 발생 시 운영자 확인 순서

Connection timeout 오류가 발생했을 때는 아래 순서로 확인하면 좋습니다.

  1. 오류 발생 시간 확인
  2. 어느 구간에서 Timeout이 발생했는지 확인
  3. 특정 사용자 문제인지 전체 문제인지 확인
  4. 출발지와 목적지 확인
  5. 도메인이라면 nslookup 확인
  6. 대상 서버 상태 확인
  7. 대상 서비스 기동 상태 확인
  8. 포트 접속 여부 확인
  9. 방화벽 허용 여부 확인
  10. 상대 시스템 상태 확인
  11. 요청 처리 시간이 긴지 확인
  12. 데이터 건수나 파일 크기 확인
  13. Timeout 설정값 확인
  14. 로그에서 오류 메시지와 응답 시간 확인
  15. 재시도 또는 재처리 필요 여부 확인
  16. 중복 처리 위험 확인
  17. 조치 후 정상 여부 확인
  18. 장애 이력 기록

이 순서대로 확인하면 Timeout 오류 대응 시 네트워크 문제와 서버 문제를 구분하기 쉬워집니다.

네트워크 담당자에게 문의할 때 전달할 정보

Timeout 오류를 네트워크 담당자에게 문의할 때는 필요한 정보를 정리해서 전달해야 합니다.

전달하면 좋은 항목은 다음과 같습니다.

  • 오류 발생 시간
  • 출발지 IP
  • 목적지 IP 또는 도메인
  • 목적지 포트
  • 프로토콜
  • 접속 방향
  • 오류 메시지
  • telnet 또는 Test-NetConnection 결과
  • nslookup 결과
  • 특정 사용자 또는 전체 사용자 여부
  • 최근 변경사항

예를 들어 다음과 같이 문의할 수 있습니다.

금일 10:30경 운영 서버에서 외부 API 서버로 호출 시 Connection timeout이 발생했습니다.
출발지 IP는 10.10.10.10, 목적지 도메인은 api.example.com, 포트는 443입니다.
동일 서버에서 telnet 테스트 시 접속 실패가 확인되어 방화벽 또는 네트워크 경로 확인 부탁드립니다.

이렇게 전달하면 네트워크 담당자가 확인해야 할 범위를 빠르게 파악할 수 있습니다.

외부 업체에 문의할 때 전달할 정보

외부 시스템 연동에서 Timeout이 발생하면 외부 업체에도 확인 요청이 필요할 수 있습니다.

전달하면 좋은 항목은 다음과 같습니다.

  • 오류 발생 시간
  • 호출한 API 또는 SFTP 서버 정보
  • 요청 URL 또는 접속 경로
  • 요청 데이터 식별값
  • 응답 코드 또는 오류 메시지
  • 우리 서버 출발지 IP
  • 상대 서버 목적지 정보
  • 재시도 여부
  • 우리 쪽 포트 테스트 결과
  • 상대 시스템 수신 여부 확인 요청

예를 들어 API Timeout은 이렇게 문의할 수 있습니다.

금일 14:10경 주문 전송 API 호출 시 Connection timeout이 발생했습니다.
당사 출발지 IP는 10.10.10.10이며, 호출 대상은 api.example.com:443입니다.
해당 시간대 당사 요청이 귀사 시스템에 수신되었는지 및 응답 지연 이력이 있었는지 확인 부탁드립니다.

외부 연동에서는 우리 쪽 로그만으로 최종 원인을 확인하기 어려울 수 있으므로 상대 시스템 수신 로그 확인이 필요합니다.

Timeout 오류 대응 시 주의할 점

Timeout 오류를 처리할 때는 몇 가지 주의할 점이 있습니다.

첫 번째, 무조건 서버 다운으로 단정하지 않아야 합니다.

Timeout은 네트워크 지연, 방화벽 차단, 상대 시스템 지연, 처리 지연 등 여러 원인으로 발생할 수 있습니다.

두 번째, 재처리 전에 중복 처리 여부를 확인해야 합니다.

API 요청이 상대 시스템에 도착했지만 응답만 지연된 경우, 다시 요청하면 중복 처리될 수 있습니다.

세 번째, Timeout 설정을 무조건 늘리지 않아야 합니다.

설정을 늘리는 것은 임시 완화일 수 있지만, 실제 응답 지연 원인을 해결하는 것은 아닐 수 있습니다.

네 번째, 특정 시간대 반복 여부를 확인해야 합니다.

매일 같은 시간에 Timeout이 발생한다면 배치, 백업, 대량 처리, 네트워크 부하와 관련이 있을 수 있습니다.

다섯 번째, 출발지와 목적지를 정확히 확인해야 합니다.

방화벽이나 네트워크 확인은 방향 정보가 정확해야 합니다.

IT 운영자가 Timeout 오류를 알아야 하는 이유

IT 운영직이나 SM팀 업무에서는 Timeout 오류를 자주 만나게 됩니다.

특히 API 연동, SFTP 전송, DB 연결, 외부 시스템 통신에서 자주 발생합니다.

Timeout 오류를 이해하면 다음을 구분할 수 있습니다.

  • 네트워크 경로 문제인지
  • 방화벽 차단 문제인지
  • 상대 시스템 응답 지연인지
  • 서버 리소스 문제인지
  • 서비스 미기동 문제인지
  • 요청 데이터 처리 지연인지
  • Timeout 설정 문제인지
  • 재처리 시 중복 위험이 있는지

이 차이를 구분할 수 있어야 개발자, 네트워크 담당자, 외부 업체와 정확히 소통할 수 있습니다.

운영자는 모든 장애를 직접 해결하지 않더라도, 원인을 좁히는 역할을 해야 합니다.

마무리

Connection timeout 오류는 요청을 보냈지만 정해진 시간 안에 응답을 받지 못했을 때 발생합니다.

사용자 입장에서는 단순히 “접속이 안 된다”로 보일 수 있지만, IT 운영자는 출발지와 목적지, 포트, 방화벽, DNS, 서버 상태, 서비스 상태, 상대 시스템 응답, 처리 시간, Timeout 설정값을 함께 확인해야 합니다.

특히 API나 SFTP 같은 외부 연동에서는 요청이 실제로 상대 시스템에 도착했는지 확인하는 것이 중요합니다.

응답만 지연된 상태에서 무조건 재처리하면 중복 데이터가 발생할 수 있기 때문입니다.

IT 운영직이나 SM팀 업무를 준비하고 있다면 Timeout 오류의 의미와 확인 순서를 익혀두는 것이 좋습니다.

Timeout은 네트워크 장애와 서버 장애를 구분하는 데 중요한 단서가 되는 오류이기 때문입니다.

다음 글에서는 네트워크 장애와 함께 자주 나오는 DNS 오류와 도메인 접속 장애 확인 방법을 정리해보겠습니다.


 

함께 보면 좋은 글