[Ruby] Could not open library 'libcurl'

- 02-28
- 25,464 회
- 0 건
원인
- 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
경로에 들어갑니다.
로그인 후 댓글내용을 입력해주세요