[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

Windows node.js 와 npm 업데이트(업그레이드)
Windows 윈도우11 시작 메뉴 위치 변경(가운데, 왼쪽)
Delphi 중복 실행 방지
Linux yum 에서 Thread died in Berkeley DB library 오류
Linux VNSTAT 설치하기
Linux 로그 삭제 및 비우기(?)
Others [FTP] 500 Illegal PORT command.
Linux .htaccess 를 이용해서 https 이동하기
Dev tips Imagek 를 이용한 썸네일 생성
GnuBoard 1364 : Field 'xxxxx' doesn't have a default value
Linux 윈도우 프로그램 실행 (centos7, wine 7.0)
Windows IPv6 켜기, 끄기
GnuBoard 회원 가입일 기준으로 이용기간 정하기
GnuBoard sql_fetch, sql_query 안쓰고 직접 mysql 사용하기
Dev tips PHP 수정시 적용이 안되는 경우 해결 (opcache 중지)
Others [맥OS] 마우스 휠 스크롤 방향 윈도우와 일치시키는 방…
Dev tips [Ruby] 윈도우에서 pod install 실행시 UTF-8 오류
Views Dev tips [Ruby] Could not open library 'libcurl'
Dev tips [Android] Error type 3: Activity class {com.?.MainAc…
Dev tips Curl 을 이용하여 파일 다운로드
Dev tips Curl 을 이용하여 json 을 post 보내기
Windows 설치하려고 하는 앱이 Microsoft에서 확인된 앱이 아닙…
Delphi Glyph 에 사용할 이미지 생성하기
Python 파이썬 아나콘다 업데이트
Delphi bsNone 인 폼에서 드래그 및 크기조절
Linux Composer 설치하기
Windows WinHTTP 사용에서 12175 에러 발생시
Dev tips 날짜필드 연장하기
Linux Swap 생성/수정
Linux 바이러스 검사