本地调用Serverless Lambda（Python3.8）时模块导入失败求助

问题原因分析 #

出现ModuleNotFoundError的核心原因是Serverless Framework本地调用时的Python模块搜索路径与直接运行lambda.py的环境不一致：

• 直接运行lambda.py时，Python会自动将当前工作目录加入sys.path，因此能识别到带有__init__.py的parser目录作为合法包。
• 而sls invoke local执行时，会在独立的上下文环境中运行函数，当前项目根目录可能未被添加到Python的模块搜索路径里，导致Python无法找到parser包。

另外，也可能存在以下次要因素：

• parser目录下的__init__.py文件为空或存在语法错误，导致Python不将其识别为有效包。
• 导入语句的大小写与实际目录/文件名不匹配（Lambda运行环境为Linux，大小写敏感，若本地是Windows可能忽略此问题）。

解决方案 #

1. 手动添加项目根目录到Python路径 #

在lambda.py的开头添加以下代码，强制将当前文件所在的项目根目录加入sys.path：

import sys
from pathlib import Path

# 将项目根目录添加到Python模块搜索路径
sys.path.append(str(Path(__file__).parent))

2. 通过serverless.yml配置PYTHONPATH环境变量 #

在serverless.yml中为函数指定PYTHONPATH环境变量，将项目根目录纳入搜索路径：

service: your-service-name

provider:
  name: aws
  runtime: python3.8
  environment:
    PYTHONPATH: ./  # 指定项目根目录为模块搜索路径

functions:
  test:
    handler: lambda.handle

3. 验证包的有效性 #

• 检查parser目录下的__init__.py是否存在且无语法错误（即使是空文件也可以，只要存在就会被识别为包）。
• 确保导入语句中的parser与实际目录名大小写完全一致，比如不要出现from Parser.utils import ...这样的大小写错误。

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