部署Django项目至AWS App Runner构建失败：pycairo找不到pkg-config

• 安装完整系统依赖包：AWS App Runner基于Amazon Linux 2，仅安装pkgconfig和cairo无法满足编译需求，必须补充开发类依赖。执行以下命令：

  yum install -y pkgconfig cairo-devel gcc python3-devel
  

  说明：cairo-devel包含pycairo编译所需的头文件与库文件，gcc是必要的编译工具，python3-devel提供Python扩展编译的核心组件。

• 手动指定pkg-config路径：若安装依赖后仍无法识别，在执行pip安装requirements前设置环境变量：

  export PKG_CONFIG_PATH=/usr/lib64/pkgconfig:/usr/share/pkgconfig
  

  Amazon Linux 2中pkgconfig的配置文件默认存放在这两个目录，设置后pip可准确定位到cairo的配置信息。

• 调整构建命令顺序：将系统依赖安装、环境变量配置与pip安装合并为一条命令，确保执行顺序正确，示例如下：

  yum install -y pkgconfig cairo-devel gcc python3-devel && export PKG_CONFIG_PATH=/usr/lib64/pkgconfig:/usr/share/pkgconfig && pip install -r requirements.txt
  

• 排查辅助技巧：若问题仍存在，可在构建脚本中添加pkg-config --list-all | grep cairo，构建日志会显示cairo的pkgconfig配置是否被识别，便于进一步定位问题。

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