如何使用Visual Code或IntelliJ本地调试Serverless代码？求指导

VS Code 调试方案 #

基于 Serverless Framework + Node.js #

• 先安装必要工具：
  • 全局安装Serverless CLI：npm install -g serverless
  • 项目内安装离线调试插件：npm install serverless-offline --save-dev
• 配置serverless.yml，添加插件声明：

  plugins:
    - serverless-offline
  custom:
    serverless-offline:
      httpPort: 3000 # 本地服务端口
  

• 配置VS Code调试配置（launch.json）：
  打开调试面板 → 点击"创建launch.json文件" → 选择"Node.js"，替换为以下内容：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "attach",
        "name": "Attach to Serverless Offline",
        "port": 9229,
        "restart": true,
        "localRoot": "${workspaceFolder}",
        "remoteRoot": "/var/task"
      }
    ]
  }
  

• 启动调试流程：
  1. 在终端执行：serverless offline --debug 9229（启动本地服务并开启调试端口）
  2. 在VS Code中给代码打上断点
  3. 触发函数（比如用curl http://localhost:3000/your-api-endpoint），断点会自动命中

基于 AWS SAM + Python #

• 安装AWS SAM CLI并初始化项目（确保本地有Python环境）
• 配置VS Code的launch.json：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": "SAM Local Debug",
        "type": "python",
        "request": "launch",
        "program": "${env:AWS_SAM_CLI_PATH}",
        "args": [
          "local",
          "invoke",
          "YourFunctionName",
          "--event",
          "${workspaceFolder}/event.json",
          "--debug-port",
          "5858"
        ],
        "port": 5858,
        "console": "integratedTerminal"
      }
    ]
  }
  

• 启动调试：直接点击VS Code调试按钮，函数会在本地运行并命中断点

IntelliJ 调试方案 #

Node.js Serverless 调试 #

• 同VS Code步骤，先安装serverless-offline并配置serverless.yml
• 新建调试配置：
  1. 点击右上角"Edit Configurations" → 新增"Node.js"配置
  2. 选择"Attach to Node.js/Chrome"类型，设置端口为9229
  3. 勾选"Restart connection on code change"
• 启动流程：
  1. 终端执行serverless offline --debug 9229
  2. 启动IntelliJ调试会话，给代码打断点
  3. 触发API请求，断点生效

Python Serverless（AWS SAM）调试 #

• 安装AWS SAM CLI，确保Python SDK配置正确
• 新建调试配置：
  1. 新增"Python"配置 → 选择"Python Debug Server"
  2. 设置端口为5858，本地路径映射为项目根目录
• 启动调试：
  1. 终端执行sam local invoke YourFunctionName --debug-port 5858
  2. 启动IntelliJ的调试会话，触发函数后即可命中断点

常见注意事项 #

• 确保本地运行时版本（Node.js/Python）与云端Serverless环境完全一致
• 调试端口不要被其他进程占用，可通过lsof -i :9229（Mac/Linux）或netstat -ano | findstr :9229（Windows）检查
• Serverless配置文件中的handler路径要与本地代码结构匹配

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