Mac上Docker已运行，执行sam local invoke却提示需Docker的问题排查

• SAM CLI无法识别Docker守护进程
  Docker在Mac默认使用Unix套接字，但SAM CLI可能没正确读取到路径。手动设置环境变量后重试：

  export DOCKER_HOST=unix:///var/run/docker.sock
  

• 用户无Docker访问权限
  当前登录用户不在docker用户组里，导致SAM CLI无法调用Docker。先执行groups确认用户组，若不在则添加：

  sudo usermod -aG docker $USER
  

  添加完成后重新登录系统生效。

• SAM CLI版本兼容性问题
  旧版SAM CLI对Mac Docker的适配性较差，升级到最新版本即可（以brew安装为例）：

  brew upgrade aws-sam-cli
  

• Docker Desktop配置异常
  打开Docker Desktop的设置，检查Settings > Advanced里的"Allow the default Docker socket to be used"是否开启。同时确认防火墙或安全软件没有拦截Docker的网络连接。

• 架构不匹配（M系列芯片Mac）
  如果是M1/M2等arm64架构的Mac，要确保安装的SAM CLI是对应arm64版本的。执行sam --version查看架构信息，若为x86_64，重新下载适配arm64的SAM CLI安装包。

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