[Ruby] Could not open library 'libcurl'
- 02-28
- 25,530 회
- 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경로에 들어갑니다.











로그인 후 댓글내용을 입력해주세요