알짜게시판

원인

• Windows 환경에서는 libcurl.dll 이 기본적으로 시스템에 포함되어 있지 않습니다.
• Ruby 라이브러리가 libcurl, libcurl.dll, libcurl.so.4, libcurl.so.4.dll 등 여러 이름으로 불러보는데, 아무 것도 없으면 위와 같은 에러가 납니다.

해결 방법

1. libcurl 다운로드

• 공식 사이트: https://curl.haxx.se/download.html
• Windows용 curl for Windows (Win32/Win64 빌드, SSL 지원 포함) 압축 파일을 받습니다.
  안에 보면 libcurl-x64.dll 또는 libcurl-4.dll 같은 이름으로 들어 있습니다.

2. 파일 이름 맞추기

• Ruby가 찾는 이름은 libcurl.dll 입니다.
• 따라서 받은 DLL 파일을 libcurl.dll 로 이름 변경합니다.

3. 경로 배치

• Rails 실행 시 Ruby의 bin 폴더 아래에 두면 가장 간단합니다:

  C:\Ruby31-x64\bin\libcurl.dll

• 또는 앱 실행 경로(예: C:/path-to-app/bin)에 두어도 됩니다.

• 좀 더 정석적으로는, PATH 에 등록된 경로(예: C:\Windows\System32)에 넣어도 됩니다.

4. 확인

• PowerShell이나 CMD에서:

  where libcurl.dll

  로 찾을 수 있으면 Ruby가 정상적으로 로드합니다.

추가 팁

• RubyInstaller for Windows + DevKit 를 쓰고 있다면, MSYS2 패키지 관리자로 libcurl 을 설치할 수도 있습니다:

  ridk exec pacman -S mingw-w64-x86_64-curl

  이렇게 하면 자동으로 bin 경로에 들어갑니다.