SAP PO REST Adapter HTTP OPTIONS 301 오류 해결법: URL 끝에 슬래시(/)를 붙여야 하는 이유

SAP Process Orchestration (PO)에서 REST Receiver Adapter를 사용할 때, PING 테스트를 실행하면 아래와 같은 오류를 만난 적 있으신가요?

Testing HTTP OPTIONS... 301: Moved Permanently

이 오류는 URL 끝에 슬래시(/)가 없을 때 발생하는 대표적인 리다이렉션 문제입니다.
이 글에서는 해당 현상의 원인과 해결 방법, 그리고 SAP PO 환경에서 안전한 REST Adapter 설정 방법을 자세히 설명합니다.

---

🔍 문제 현상 요약

• PING 테스트 시 오류 메시지:
  Testing HTTP OPTIONS... 301: Moved Permanently
• 해결 방법:
  URL 끝에 /를 추가하면 정상 응답 (200 OK) 수신됨

---

⚠️ 301 Moved Permanently 오류의 의미

HTTP 상태 코드 301은 리소스의 위치가 영구적으로 변경되었음을 나타내는 리다이렉션 응답입니다.

• 예:
  요청한 URL이 https://api.example.com/data → 실제 자원 위치는 https://api.example.com/data/

많은 웹 서버(Apache, Nginx, Spring Boot 등)는 슬래시(/)가 없는 URL 요청 시, 내부적으로 슬래시를 붙인 주소로 리다이렉트하도록 설정되어 있습니다.

---

🧠 SAP PO의 REST Adapter와 리다이렉션의 관계

SAP PO의 REST Receiver Adapter는 기본적으로 301과 같은 리다이렉션 응답을 자동으로 따라가지 않습니다.

특히,

• PING 테스트는 HTTP OPTIONS 메서드를 사용
• 리다이렉션 응답(301)을 수신해도 이를 따르지 않고 바로 오류 처리
• / 없는 URL → "Moved Permanently" 메시지 출력
• / 포함된 URL → 정상적으로 200 OK 수신

📌 중요 포인트:
실제 메시지 전송에는 영향이 없을 수 있지만, PING 테스트나 Pre-flight Request에서는 오류로 보일 수 있음

---

🔧 해결 방법 및 권장 설정

✅ 대응 방안

1. REST Receiver Adapter의 Endpoint URL 설정 시 슬래시(/)를 포함
   • 예: https://api.example.com/data/
   • 잘못된 예: https://api.example.com/data
2. 외부 API 문서에서 URL 패턴 확인
   • 디렉토리형 URL이면 슬래시 꼭 포함
3. 테스트 중 301 Moved Permanently 오류 발생 시,
   • URL 끝에 /을 붙이고 다시 시도

---

📌 마무리 요약

항목 설명

오류 메시지	Testing HTTP OPTIONS... 301: Moved Permanently
주요 원인	URL에 슬래시(/) 누락 → 리다이렉션 발생
PO 동작 방식	REST Adapter는 301 응답을 자동으로 따르지 않음
해결 방법	URL 끝에 슬래시 붙이기
권장사항	REST Adapter Endpoint는 항상 / 포함하여 설정