AWS Lambda部署openpyxl层报错：No module named 'openpyxl'求助

以下是排查和解决该问题的关键步骤：

1. 检查Lambda层的打包目录结构 #

Lambda对Python层的目录结构有严格要求，库文件必须放在python/lib/python<版本号>/site-packages/路径下（<版本号>需匹配你的Lambda运行时版本，比如3.9、3.10），很多报错都是因为打包结构不正确导致的。

正确的打包步骤：

• 先创建目标目录：

  mkdir -p python/lib/python3.9/site-packages/
  

• 安装openpyxl到指定目录：

  pip install openpyxl -t python/lib/python3.9/site-packages/
  

• 将整个python文件夹打包为zip文件（注意是打包文件夹本身，不是直接打包里面的内容）。

2. 确认Lambda函数已正确关联层 #

进入Lambda函数的配置页面，在「Layers」选项中检查是否已添加你创建的openpyxl层，且层的版本是最新的有效版本。如果未关联或关联了错误版本，会导致模块找不到。

3. 匹配Lambda运行时与打包时的Python版本 #

确保你打包openpyxl时使用的Python版本，和Lambda函数配置的运行时版本完全一致。比如你用Python3.9打包的层，Lambda运行时必须设置为Python3.9，版本不兼容会导致模块无法识别。

4. 验证zip包内容 #

本地解压你创建的层zip包，检查路径是否为python/lib/python<版本号>/site-packages/openpyxl，同时确认该目录下包含openpyxl的所有文件，以及它的依赖库（比如et-xmlfile）。如果依赖缺失，也会导致导入失败。

5. 用极简代码测试层有效性 #

创建一个测试Lambda函数，仅保留以下代码，排除业务代码的干扰：

import openpyxl

def lambda_handler(event, context):
    return {"message": "openpyxl imported successfully"}

运行测试，若仍报错，说明层的问题；若成功，则问题出在你的业务代码或其他配置上。

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