[PiggyAI] Upstash 를 이용한 서버리스 환경에서의 Redis 연결과 TLS 에러 해결

🐷 Upstash

Redis 를 프로젝트에 붙이기로 했을 때 여러 선택지가 있었다. ( Docker, 로컬 설치 등등 )

하지만 기존 배포 환경을 고려했을 때 서버리스 환경에서 vercel 로 배포가 되어있는 만큼 Redis 를 HTTP 기반 서버리스 환경에서도 쓸 수 있도록 최적화 되어있는 Upstash 를 이용해 Redis Cloud 를 사용하기로 했다.

 

🐷 TLS 에러

인기 검색어 기능을 위해 Redis 를 연결했는데, npm run dev 후 서버에서 검색 API 를 호출하자마자 에러가 발생했다.

 

❗ 원인

처음에 Redis 연결을 위해 .env.local 파일에 아래와 같이 접속 주소만 넣었다.

REDIS_URL=redis://:비밀번호@gorgeous-wren-38298.upstash.io:6379

 

그런데 이 주소는 비암호화된 Redis 연결 방식 ( redis:// ) 으로, Upstash 처럼 보안을 중요시하는 클라우드 Redis 는 기본적으로 TLS ( 암호화 통신 ) 을 강제한다.

그래서 서버에서 Redis 와 연결을 시도하면 연결이 끊기고 ( ECONNRESET ), 요청이 계속 실패해서 MaxRetiresPerRequestError 가 발생했다.

 

✅ 해결 방법

.env.local 에서 한번에 URL 을 설정하는 대신 아래처럼 TLS 옵션을 직접 설정한 redis 클라이언트 코드로 수정했다.

const Redis = require('ioredis');

const redis = new Redis({
    host: process.env.REDIS_HOST,
    port: process.env.REDIS_PORT,
    password: process.env.REDIS_PASSWORD,
    tls: {}, // TLS 활성화
    maxRetriesPerRequest: 3, // 너무 많이 재시도 안 하도록 제한
});

module.exports = redis;

 

이렇게 설정하고 실행했더니 에러 없이 잘 작동했다.

 

💡 TLS란?

TLS ( Transport Layer Security ) 는 데이터를 암호화해서 안전하게 주고받는 보안 프로토콜이다.

• 우리가 자주 쓰는 HTTPS 도 TLS 위에서 동작한다.
• Redis 같은 외부 서비스와 데이터를 주고받을 때 중간에서 누군가 훔쳐보거나 조작하지 못하게 막아준다.
• Upstash 와 같은 Redis 클라우드는 이걸 기본 보안 정책으로 요구한다.