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

コメント

お役立ち掲示板

Linux 데몬(systemd service) 작성 및 실행하기
開発のヒント Porto 테마에서 포스팅만 Loading Overlay
GnuBoard 아이디 대신 이메일로 회원 가입하기
Kilho.net 시크릿DNS - Kaspersky 백신 사용시 DNS 암호화 관련
Kilho.net 칼무리 - 영역화면 크기 오류인 경우
開発のヒント 업데이트 이후 에러 발생([ERROR] Incorrect definition…
その他 구글 크롬 탭검색 비활성화
開発のヒント MySQL, MariaDB 업데이트
その他 아이폰 - 비공개 릴레이로 HTTPS 감청 막기
Windows Windows에 Rust 설치하기
その他 HTTPS/DNS 차단 쉽게 이해하기
Kilho.net ChangeDNS - DNS 서버를 손쉽게 변경합니다.
開発のヒント [RN] android directory was detected in the project.
Linux 메일(Mail) 삭제/초기화
Delphi 윈도우 알림센터에 메시지 출력하기
GnuBoard 사이드바 만들기
その他 텔레그램 봇 (Telegram Bot) 만들기
開発のヒント [부트스트랩] nav 에서 하위 항목 활성화 시 부모 항목 …
Linux PHP 버전 추가하기
開発のヒント Curl 접속 속도가 늦은 경우
Windows 파일 내용 검색
開発のヒント unblock with 'mysqladmin flush-hosts' 에러
開発のヒント [ReactNative] 캐시 초기화 하는 방법
Kilho.net killer 네트워크 이슈 팁
Windows node.js 와 npm 업데이트(업그레이드)
Windows 윈도우11 시작 메뉴 위치 변경(가운데, 왼쪽)
Delphi 중복 실행 방지
Linux yum 에서 Thread died in Berkeley DB library 오류
Linux VNSTAT 설치하기
Linux 로그 삭제 및 비우기(?)