使用Serverless部署AWS Lambda的Slack应用时导入本地JS文件失效

核心原因分析 #

你遇到的问题是导入app_home.js后Lambda初始化阶段就触发错误，导致handler完全无法响应请求，大概率是以下几类原因：

• app_home.js本身存在语法错误、依赖缺失或者运行时报错
• 部署打包时app_home.js没有被打入Lambda的部署包
• 文件名大小写不匹配（Windows本地开发正常，Linux运行环境找不到文件）
• app_home.js顶层代码引用了未在Lambda配置的环境变量/资源

具体排查步骤 #

1. 本地先验证导入逻辑
   本地终端执行以下命令，看是否直接报错：

node -e "require('./app_home')"

如果执行报错，先解决app_home.js本身的语法错误、未安装的依赖引用、未定义变量等问题。

2. 查看Lambda运行日志定位问题
   登录AWS控制台，找到你部署的Lambda函数，进入「监控」→「日志」查看最近的执行记录，错误日志会直接给出明确的问题原因：

• 如果提示Cannot find module './app_home'，说明文件未被打包进部署包
• 如果是其他语法错误、引用错误，直接对应修复app_home.js的代码即可

3. 解决打包遗漏问题
   如果日志提示找不到文件，在serverless.yml中显式配置打包包含的文件，添加如下配置：

service: slack-app-bolt-js-forto
frameworkVersion: '2'
provider:
  # 原有配置保持不变
# 新增package配置
package:
  include:
    - app.js
    - app_home.js
  exclude:
    - .git/**
    - .serverless/**
    - *.log
# 原有functions、plugins配置保持不变

重新执行sls deploy部署即可。

4. 检查文件名大小写
   确认本地app_home.js的文件名和导入语句require('./app_home')的大小写完全一致，Windows环境文件名大小写不敏感，本地运行不会报错，但Lambda运行的Linux环境大小写敏感，大小写不一致会直接找不到文件。

5. 检查app_home.js顶层代码
   确认app_home.js中没有顶层的未捕获异常、未处理的异步调用、或者访问本地才有的资源（比如本地文件、本地环境变量），这类问题会导致Lambda初始化阶段直接失败，无法处理请求。

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