构建C++应用时链接amqpcpp库报错：/usr/bin/ld: cannot find -lamqpcpp

在构建依赖AMQPcpp（RabbitMQ的C客户端）的C应用Docker镜像过程中，已成功编译安装AMQPcpp，但最终应用构建的链接阶段出现错误：/usr/bin/ld: cannot find -lamqpcpp。以下是相关文件内容、完整报错信息及解决步骤：

Dockerfile内容 #

FROM ubuntu:20.04

# Set environment variables
ENV DEBIAN_FRONTEND=noninteractive

# Update and install required packages 
RUN apt-get update && apt-get install -y \
    g++ \
    cmake \
    make \
    libpthread-stubs0-dev \
    git \
    openssl \
    libssl-dev \
    && rm -rf /var/lib/apt/lists/*

RUN apt-get update && \
    apt-get install -y ninja-build && \
    rm -rf /var/lib/apt/lists/*
    
# Create a directory for the app
WORKDIR /app

# Copy your CMake project files into the container
COPY . .

RUN cd /app

# # cd amqpcpp and build amqpcpp
RUN cd amqpcpp \
    && mkdir build && cd build \
    && cmake .. && cmake --build . --target install  && make && make install

RUN cd /app 

WORKDIR /app/build

RUN cmake -DCMAKE_BUILD_TYPE=Release .. && \
    cmake --build . --parallel 8

ENTRYPOINT [ "./app/build/exchange_main" ]

CMakeLists.txt内容 #

cmake_minimum_required(VERSION 3.0)

project(MatchingEngine)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_COMPILER g++)
set(CMAKE_CXX_FLAGS "-std=c++2a -Wall -Wextra -Werror -Wpedantic")
set(CMAKE_VERBOSE_MAKEFILE on)


set(COMMON_DIR ${CMAKE_SOURCE_DIR}/common)
set(RABBITMQ_C_SOURCE_DIR ${COMMON_DIR}/rabbitmq-c-0.13.0)
# set(CMAKE_PREFIX_PATH ${CMAKE_SOURCE_DIR}/amqpcpp)

# Include directories for RabbitMQ-C headers

include_directories(${RABBITMQ_C_SOURCE_DIR}/librabbitmq)


add_subdirectory(common)
add_subdirectory(exchange)

list(APPEND LIBS libcommon)
list(APPEND LIBS libexchange)
list(APPEND LIBS pthread)
list(APPEND LIBS amqpcpp)

include_directories(${PROJECT_SOURCE_DIR})
include_directories(${PROJECT_SOURCE_DIR}/exchange)

# Specify the directory where amqpcpp library is located
add_executable(exchange_main exchange/exchange_main.cpp)
# target_include_directories(exchange_main PRIVATE /usr/local/include)
target_link_libraries(exchange_main PUBLIC ${LIBS})

完整报错信息 #

#0 2.570 /usr/bin/cmake -E cmake_link_script CMakeFiles/exchange_main.dir/link.txt --verbose=1
#0 2.576 g++  -std=c++2a -Wall -Wextra -Werror -Wpedantic -O3 -DNDEBUG  -rdynamic CMakeFiles/exchange_main.dir/exchange/exchange_main.cpp.o  -o exchange_main  common/liblibcommon.a exchange/liblibexchange.a -lpthread -lamqpcpp 
#0 2.598 /usr/bin/ld: cannot find -lamqpcpp
#0 2.598 collect2: error: ld returned 1 exit status
#0 2.600 make[2]: *** [CMakeFiles/exchange_main.dir/build.make:89: exchange_main] Error 1
#0 2.600 make[2]: Leaving directory '/app/build'
#0 2.600 make[1]: *** [CMakeFiles/Makefile2:121: CMakeFiles/exchange_main.dir/all] Error 2

解决步骤 #

1. 修正Dockerfile冗余操作 #

• 移除无效的RUN cd /app命令（每个RUN指令是独立shell，切换目录不影响后续指令）。
• 简化AMQPcpp编译流程：cmake --build . --target install已包含编译和安装，删除重复的&& make && make install，修改后：

  RUN cd amqpcpp \
      && mkdir build && cd build \
      && cmake .. && cmake --build . --target install
  

2. 让CMake找到AMQPcpp库 #

方法一：添加库搜索路径

在CMakeLists.txt中添加AMQPcpp默认安装路径（/usr/local/lib）：

# 添加AMQPcpp库搜索路径
link_directories(/usr/local/lib)

方法二：使用find_package（规范做法）

如果AMQPcpp安装时生成了cmake配置文件，替换手动添加库的方式：

# 注释原手动添加的amqpcpp
# list(APPEND LIBS amqpcpp)

# 查找AMQPcpp库
find_package(AMQPcpp REQUIRED)
# 链接官方提供的库目标
target_link_libraries(exchange_main PUBLIC ${LIBS} AMQPcpp::AMQPcpp)

3. 更新系统库缓存 #

在Dockerfile安装完AMQPcpp后，执行ldconfig让系统识别新安装的库：

RUN cd amqpcpp \
    && mkdir build && cd build \
    && cmake .. && cmake --build . --target install \
    && ldconfig

4. 验证库文件是否存在 #

可在Dockerfile中添加验证步骤，确认AMQPcpp库已正确安装：

RUN ls -la /usr/local/lib/libamqpcpp*

如果无libamqpcpp.a或libamqpcpp.so输出，说明AMQPcpp安装失败，需检查其源码的CMake配置。

内容的提问来源于stack exchange，提问作者Sijibomi