[Ruby] Could not open library 'libcurl'

원인

  • 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 경로에 들어갑니다.

Comments

Tips & Tech

Others [FTP] 500 Illegal PORT command.
Linux .htaccess 를 이용해서 https 이동하기
Dev tips Imagek 를 이용한 썸네일 생성
Dev tips 파일 포맷 알아내기
GnuBoard 1364 : Field 'xxxxx' doesn't have a default value
GnuBoard 웹폰트 적용하기
GnuBoard CKEditor 5 플러그인
Linux 윈도우 프로그램 실행 (centos7, wine 7.0)
Kilho.net [시크릿DNS] 프록시 혼합 사용 예제
Windows IPv6 켜기, 끄기
GnuBoard 회원 가입일 기준으로 이용기간 정하기
GnuBoard sql_fetch, sql_query 안쓰고 직접 mysql 사용하기
Linux 웹서버 상태 확인 후 자동 재시작 쉘 스크립트
Kilho.net WinDivert 1753 에러 발생시
Dev tips PHP 수정시 적용이 안되는 경우 해결 (opcache 중지)
Others [맥OS] 마우스 휠 스크롤 방향 윈도우와 일치시키는 방…
Dev tips [Ruby] 윈도우에서 pod install 실행시 UTF-8 오류
Views Dev tips [Ruby] Could not open library 'libcurl'
Kilho.net WinDivert 서비스 종료
Dev tips [Android] Error type 3: Activity class {com.?.MainAc…
Windows 윈도우 서버 2016 IIS 중지
GnuBoard 새 글 정리하기
Dev tips WinDivert 오류코드
Dev tips Curl 을 이용하여 파일 다운로드
Dev tips Curl 을 이용하여 json 을 post 보내기
GnuBoard CKEditor 5 플러그인
Kilho.net 칼무리 자동실행이 안 되는 원인를 찾았습니다
Dev tips 워드프레스와 그누보드 연동 모듈
Windows 설치하려고 하는 앱이 Microsoft에서 확인된 앱이 아닙…
Delphi 권한상승