适配AWS Lambda的PHP API Docker镜像：CodeBuild成功但Lambda运行失败

Amazon Linux 2 与原基础镜像的核心差异 #

• 系统库与依赖版本：原public.ecr.aws/lambda/provided基于Amazon Linux 1（AL1），其glibc版本、系统库路径（如/usr/lib64下部分库结构）与Amazon Linux 2（AL2）存在差异，AL2使用更高版本的glibc，旧环境编译的PHP二进制文件会因依赖不兼容无法运行。
• Lambda运行环境变量：AL2镜像的默认LD_LIBRARY_PATH、PATH与AL1不同，未显式配置的话，PHP可能找不到自身的依赖库或执行命令。
• 默认运行用户：AL2的Lambda执行环境默认使用sailor用户（UID 1000），而非AL1的root用户，权限配置不当会导致文件读取/执行失败。

针对性排查与修复步骤 #

1. 确保PHP及扩展基于AL2环境编译 #

如果你的PHP 8.0.16是在AL1或其他非AL2环境编译的，会直接因glibc版本不兼容报错。解决方式：

• 在amazon/aws-lambda-provided:al2镜像中重新编译PHP，或使用AL2预编译的PHP二进制包。
• 编译时可添加静态编译参数（如--enable-static），避免动态库依赖问题；若使用动态编译，需将所有依赖的系统库复制到镜像的/opt/lib目录，并在bootstrap脚本中指定LD_LIBRARY_PATH。

2. 调整bootstrap脚本的环境变量配置 #

在bootstrap开头显式设置适配AL2的环境变量，示例：

#!/bin/sh
# 配置PHP库路径和执行路径
export LD_LIBRARY_PATH="/opt/php/lib:/opt/lib:$LD_LIBRARY_PATH"
export PATH="/opt/php/bin:$PATH"
# 启动PHP处理Lambda请求
exec /opt/php/bin/php -f /var/task/your-handler.php

避免使用AL1特有的命令或路径（如/usr/bin/python2，AL2默认仅提供/usr/bin/python3）。

3. 修正文件权限与用户上下文 #

AL2默认以UID 1000用户运行Lambda进程，需确保应用文件、PHP二进制文件的权限允许该用户访问：

# 在Dockerfile中添加权限配置
RUN chmod -R 755 /opt/php /var/task
RUN chown -R 1000:1000 /opt/php /var/task

不要在镜像中强制设置USER root，避免与Lambda运行环境的用户权限冲突。

4. 查看CloudWatch日志定位具体错误 #

Lambda运行异常时，优先查看CloudWatch Logs中的执行日志，常见错误包括：

• PHP动态扩展加载失败：检查扩展路径是否在LD_LIBRARY_PATH中，且扩展是基于AL2编译的。
• 文件权限不足：确认对应文件的所有者/权限配置。
• 命令找不到：检查PATH是否包含PHP可执行文件路径。

5. 优化Dockerfile构建流程（多阶段构建示例） #

使用多阶段构建确保PHP在AL2环境编译，避免兼容性问题：

# 构建阶段：在AL2中编译PHP
FROM amazon/aws-lambda-provided:al2 AS builder
RUN yum install -y gcc make openssl-devel libxml2-devel curl
WORKDIR /tmp
RUN curl -O https://www.php.net/distributions/php-8.0.16.tar.gz
RUN tar xzf php-8.0.16.tar.gz && cd php-8.0.16
RUN ./configure --prefix=/opt/php --enable-cli --with-openssl --with-libxml
RUN make && make install

# 最终镜像：仅保留必要文件
FROM amazon/aws-lambda-provided:al2
COPY --from=builder /opt/php /opt/php
COPY bootstrap /var/runtime/bootstrap
COPY your-app-code/ /var/task/
RUN chmod 755 /var/runtime/bootstrap
RUN chown -R 1000:1000 /opt/php /var/task
CMD ["your-handler.php"]

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