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

댓글

알짜게시판

개발팁 VSCode 한국어 설정법, Configure Display Language로 U…
개발팁 Apache Access Log 기반 도메인별 방문자 카운터 구현
개발팁 네이버 검색 Open API
개발팁 네이버 검색광고 키워드 도구 API 검색
개발팁 MariaDB column_stats 테이블 오류 해결 방법
개발팁 PHP-FPM 에러 로그 실시간 모니터링
개발팁 다국어 번역 함수 구현 방법
개발팁 애드센스 충돌 문제 해결하기
개발팁 애드센스 자동 광고 사용 시 빈 화면이 출력된다면?
개발팁 검색 로봇 접속시 종료
개발팁 REQUEST 값 받기(application/json 포함)
개발팁 Porto 테마에서 포스팅만 Loading Overlay
개발팁 업데이트 이후 에러 발생([ERROR] Incorrect definition…
개발팁 MySQL, MariaDB 업데이트
개발팁 [RN] android directory was detected in the project.
개발팁 [부트스트랩] nav 에서 하위 항목 활성화 시 부모 항목 …
개발팁 Curl 접속 속도가 늦은 경우
개발팁 unblock with 'mysqladmin flush-hosts' 에러
개발팁 [ReactNative] 캐시 초기화 하는 방법
개발팁 Imagek 를 이용한 썸네일 생성
개발팁 파일 포맷 알아내기
개발팁 PHP 수정시 적용이 안되는 경우 해결 (opcache 중지)
개발팁 [Ruby] 윈도우에서 pod install 실행시 UTF-8 오류
열람 개발팁 [Ruby] Could not open library 'libcurl'
개발팁 [Android] Error type 3: Activity class {com.?.MainAc…
개발팁 WinDivert 오류코드
개발팁 Curl 을 이용하여 파일 다운로드
개발팁 Curl 을 이용하여 json 을 post 보내기
개발팁 워드프레스와 그누보드 연동 모듈
개발팁 날짜필드 연장하기