本地运行Go Lambda（SAM）时如何获取环境变量中的SQS URL？

这个问题我之前也碰到过！核心原因是SAM Local在本地运行时不会自动创建AWS云资源（比如你的SQS队列），所以!Ref MyQueue没办法解析出实际的队列URL，导致环境变量为空。下面给你几个实用的解决办法：

方案1：用本地环境变量文件覆盖推荐 #

SAM Local支持通过--env-vars参数加载本地环境变量，专门用来解决这种本地调试时的资源引用问题：

• 先创建一个本地环境变量文件，比如local-env.json，内容如下：

{
  "APIGetFunction": {
    "QueueUrl": "http://localhost:4566/000000000000/test_queue"
  }
}

这里的URL格式是LocalStack本地SQS的默认格式（000000000000是本地模拟的AWS账号ID），如果你用其他工具模拟SQS，替换成对应的URL即可。

• 启动本地API时指定这个文件：

sam local start-api --env-vars local-env.json

方案2：用LocalStack模拟完整AWS环境更贴近真实场景 #

如果需要模拟更多AWS服务（不止SQS），LocalStack是个很好的选择：

• 先安装并启动LocalStack用Docker最方便：

localstack start -d

• 创建本地SQS队列：

awslocal sqs create-queue --queue-name test_queue --region eu-west-3

• 获取本地队列URL：

awslocal sqs get-queue-url --queue-name test_queue --region eu-west-3

把返回的URL填到上面的local-env.json里，或者直接在代码里用。

方案3：代码层做本地调试 fallback最简单快速 #

如果只是临时调试，不想折腾配置文件或工具，可以直接在Go代码里加个兜底逻辑：

import "os"

func main() {
    queueURL := os.Getenv("QueueUrl")
    // 本地调试时自动使用默认的本地队列URL
    if queueURL == "" {
        queueURL = "http://localhost:4566/000000000000/test_queue"
    }
    // 后续用queueURL操作SQS即可
}

方案4：用CloudFormation条件区分本地/部署环境更优雅 #

如果想在模板里统一管理本地和部署的配置，可以加个参数和条件：

• 修改你的template.yaml，添加参数和条件：

Parameters:
  IsLocal:
    Type: String
    Default: "false"
    AllowedValues: ["true", "false"]

Conditions:
  RunningLocally: !Equals [!Ref IsLocal, "true"]

APIGetFunction:
  Type: 'AWS::Serverless::Function'
  Properties:
    Handler: service_get_person
    Runtime: go1.x
    CodeUri: ./src/person/service/get_person
    Description: 'Get a person'
    MemorySize: 128
    Timeout: 30
    Role: !GetAtt LambdaExecutionRole.Arn
    Events:
      GetEvent:
        Type: Api
        Properties:
          Path: /person
          Method: get
    Environment:
      Variables:
        QueueUrl: !If [RunningLocally, "http://localhost:4566/000000000000/test_queue", !Ref MyQueue]
        REGION: eu-west-3

MyQueue:
  Type: AWS::SQS::Queue
  Properties:
    QueueName: test_queue
    DelaySeconds: 0
    VisibilityTimeout: 120

• 本地启动时指定参数：

sam local start-api --parameter-overrides IsLocal=true

这样部署到AWS时不用改任何东西，本地调试时只要加个参数就行，非常方便。

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