Docker编译libpq程序报错及Mac上Valgrind内存泄漏检测求助

问题现象 #

构建镜像时出现头文件找不到错误：

tmp.c:4:10: fatal error: libpq-fe.h: No such file or directory
#include "libpq-fe.h"
^~~~~~~~~~~~
compilation terminated.

原因分析 #

libpq-dev包安装后，头文件默认位于/usr/include/postgresql目录，而GCC的默认头文件搜索路径不包含该目录，因此编译时无法找到libpq-fe.h。

解决方法 #

方法1：手动指定头文件路径 #

修改Dockerfile中的编译命令，添加-I/usr/include/postgresql参数指定头文件目录：

FROM ubuntu:latest

RUN apt-get update && \
    apt-get install -y build-essential libpq-dev

WORKDIR /app

COPY tmp.c .

# 添加-I参数指定libpq头文件路径
RUN gcc -Wall -Wextra -pedantic -g -o my_program tmp.c -I/usr/include/postgresql -lpq

CMD ["./my_program"]

方法2：使用pkg-config自动获取编译参数 #

libpq-dev包含pkg-config配置文件，用pkg-config可自动生成正确的编译（头文件路径）和链接（库文件路径）参数，更可靠：

FROM ubuntu:latest

RUN apt-get update && \
    apt-get install -y build-essential libpq-dev pkg-config

WORKDIR /app

COPY tmp.c .

# 用pkg-config自动生成编译和链接参数
RUN gcc -Wall -Wextra -pedantic -g -o my_program tmp.c $(pkg-config --cflags --libs libpq)

CMD ["./my_program"]

现状说明 #

Mac系统（尤其是M系列ARM芯片）对Valgrind的官方支持极差，Intel Mac虽可安装，但随系统版本更新易出现兼容性问题，这也是你使用leak工具效果不佳的核心原因之一。

可行方案 #

方案1：在Docker容器中运行Valgrind（推荐） #

利用Docker的Linux环境，Valgrind可正常工作，步骤如下：

1. 修改Dockerfile，安装Valgrind：

FROM ubuntu:latest

RUN apt-get update && \
    apt-get install -y build-essential libpq-dev pkg-config valgrind

WORKDIR /app

COPY tmp.c .

RUN gcc -Wall -Wextra -pedantic -g -o my_program tmp.c $(pkg-config --cflags --libs libpq)

# 默认启动Valgrind全量泄漏检测
CMD ["valgrind", "--leak-check=full", "./my_program"]

2. 构建并运行容器查看结果：

docker build . -t my_image
docker run --rm my_image

若不想修改默认CMD，可在运行时手动指定命令：

docker run --rm my_image valgrind --leak-check=full --show-leak-kinds=all ./my_program

方案2：Intel Mac安装Valgrind（仅适配Intel架构） #

通过Homebrew安装适配版本：

brew install valgrind

若官方源无适配版本，尝试第三方tap：

brew tap LouisBrunner/valgrind
brew install --HEAD LouisBrunner/valgrind/valgrind

安装完成后本地直接运行：

valgrind --leak-check=full ./my_program

注意：该方法仅适用于Intel Mac，M系列芯片无法使用。

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