알짜게시판

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

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

제목 글쓴이 조회 날짜
[칼무리] 외부 명령으로 캡처 자동화하기 1 11,818 25-10-14
[윈도우] 윈도11 강제업데이트 피하고 윈도10 계속 쓰기 13,955 25-10-12
[리눅스] PHP 파일 업로드 용량 늘리기 29,362 25-10-03
[HTML] 애드센스 충돌 문제 해결하기 50,583 25-09-20
[파이썬] Python Playwright로 Edge 브라우저 제어하기 63,273 25-09-12
[델파이] TDirectory.Delete 대신 CMD 으로 폴더 삭제 65,324 25-09-10
[윈도우] Chrome 및 Edge를 TLS 1.2 모드로 실행 73,381 25-08-30
[HTML] 애드센스 자동 광고 사용 시 빈 화면이 출력된다면? 158,475 25-06-20
[윈도우] 브라우저 환경설정 추출 144,946 25-06-18
[워드프레스] xmlrpc.php 차단으로 보안 강화하기 136,299 25-06-05
[델파이] 폼이 모니터 한 가운데 있는 경우 자연스럽게 왼쪽으로 이동시키기 133,881 25-05-26
[윈도우] WSH script registration is not valid. 133,989 25-05-23
[워드프레스] 제목 블록 기본값을 H5로 변경하는 방법 115,440 25-05-22
[파이썬] 동영상 특정 영역 모자이크(흐리게) 하기 47,043 25-04-30
[리눅스] 구글 크롬 콘솔 'Attestation check for Topics on' 에러 원인 & 해결방… 60,147 25-04-11
[크롬] 개발자 도구(DevTools)에서 붙여넣기 안될때 72,394 25-03-10
[그누보드] SmartEditor2Skin.html 다운로드 되는 현상 110,373 25-01-08
[윈도우] 네트워크 탐지 114,708 24-12-31
[델파이] TrayIcon 이 흐릿하게 보이는 버그? 수정 128,336 24-12-12
[델파이] 실행 중인 프로세스가 활성 창인지 확인하는 함수 145,641 24-11-02
[델파이] 메세지 다이어그램(Message Dialog) 에 체크박스(CheckBox) 추가 132,554 24-10-30
[그누보드] 부트스트랩 테마 예제로 사용중인 main.php 116,139 24-10-21
[그누보드] 유튜브 스킨 75,479 24-10-14
[윈도우] TLS 연결 끊김 해결 방법 - Kyber 비활성화 265,719 24-10-12
[PHP] 검색 로봇 접속시 종료 56,646 24-10-07
[윈도우] WinDivert 사용중인 어플리케이션 검색 45,932 24-09-12
[워드프레스] 답글 남기기 메시지 변경 43,103 24-09-05
[리눅스] PHP-FPM 튜닝을 위한 메모리 계산 41,676 24-08-29
[윈도우] 아이폰 벨소리 쉽게 추가하기 94,547 24-06-14
[윈도우] C:\Windows\Installer 폴더 다른 드라이브로 옮기기 105,242 24-05-29
[윈도우] 작업 표시줄 (기타 시스템 트레이 아이콘) 제거 프로그램 188,872 24-05-18
철학인문광고의비밀바투어지원톡톡결혼의신