Node.js AWS SDK Step Functions客户端无法加载自定义配置，请求未指向本地Step Functions服务

看起来你踩了AWS SDK v3一个很容易犯的小语法坑——问题出在你构造SFNClient时传入配置的方式上，导致自定义的endpoint、凭证等配置根本没被SDK正确读取，请求才会默认发往AWS官方的Step Functions端点。

核心问题：错误的配置传递方式 #

你现在的代码是把配置放在一个数组里传给SFNClient：

sfnLocalClient = new SFNClient([{
  endpoint: `http://localhost:8083`,
  region: 'eu-west-1',
  credentials: {
    accessKeyId: 'dummy',
    secretAccessKey: 'dummy',
  },
}]);

但AWS SDK v3的客户端构造函数接收的是单个配置对象，不是数组。你传入的数组会被SDK解构后当成嵌套的配置结构，导致中间件在读取endpoint等属性时，找不到正确的取值路径（就像你调试时看到的，配置被塞进了o属性里）。

修正后的正确写法 #

只需要去掉包裹配置的数组，直接传入配置对象即可：

// 导入必要的模块
import { SFNClient, CreateStateMachineCommand } from "@aws-sdk/client-sfn";
import { readFileSync } from "fs";

// 正确构造SFN客户端
const sfnLocalClient = new SFNClient({
  endpoint: `http://localhost:8083`,
  region: 'eu-west-1',
  credentials: {
    accessKeyId: 'dummy',
    secretAccessKey: 'dummy',
  },
});

// 创建状态机的逻辑保持不变
const stateMachine = await sfnLocalClient.send(
  new CreateStateMachineCommand({
    name: 'TestStateMachine',
    roleArn: 'arn:aws:iam::012345678901:role/DummyRole',
    definition: readFileSync('test.json', 'utf8'),
  })
);

为什么这个写法能解决问题？ #

SDK的SFNClient构造函数用了剩余参数语法constructor(...[configuration])，这里的...是把所有传入的参数收集成数组，然后取第一个元素作为配置对象。如果你直接传单个配置对象，configuration就会正确指向这个对象；但如果你传的是一个数组，configuration就变成了这个数组，SDK内部读取配置时自然找不到正确的属性。

额外验证与注意事项 #

1. 修正后，region和credentials也会被正确加载，不会再出现“缺少region”“无凭证提供”这类错误；
2. 确认你的@aws-sdk/client-sfn版本（3.398.0）是兼容这种配置方式的，SDK v3从发布起就采用单对象配置的模式；
3. 如果还是有问题，可以开启SDK调试日志排查：设置环境变量AWS_SDK_DEBUG=true，或者在客户端配置里添加logger: console，查看配置加载和请求发送的详细过程；
4. 确保Docker映射的Step Functions Local端口（8083）和代码里的endpoint端口完全一致。

备注：内容来源于stack exchange，提问作者Chris