AWS Elemental MediaConvert的createJob()在JS SDK无效但AWS控制台运行正常

排查&解决步骤 #

1. 优先修正MediaConvert客户端初始化逻辑
   AWS MediaConvert不支持使用通用服务端点，必须使用对应区域下你账号专属的服务端点，直接使用默认初始化的客户端会导致请求无响应挂死，这是该场景下最常见的问题。
   AWS SDK v2 初始化参考代码：

const AWS = require('aws-sdk');
const mediaConvertInit = new AWS.MediaConvert({ region: '你的资源所在区域，比如us-east-1' });

// 先获取专属端点
mediaConvertInit.describeEndpoints({ MaxResults: 0 }).promise()
.then(endpointRes => {
  // 用专属端点初始化正式客户端，同时添加超时避免无限挂住
  const mediaConvertClient = new AWS.MediaConvert({
    region: '你的资源所在区域',
    endpoint: endpointRes.Endpoints[0].Url,
    httpOptions: {
      timeout: 30000 // 30秒超时，超时后会抛出错误
    }
  });
  // 执行创建任务逻辑
  return mediaConvertClient.createJob(jobTemplate).promise();
})
.then(res => console.log('compress success', res))
.catch(err => console.log('compress fail', err));

如果使用AWS SDK v3，注意不要混用v2的promise()调用逻辑，参考写法：

import { MediaConvertClient, CreateJobCommand } from "@aws-sdk/client-mediaconvert";
const client = new MediaConvertClient({ 
  region: "你的资源所在区域",
  endpoint: "你的专属端点地址"
});
const command = new CreateJobCommand(jobTemplate);
client.send(command)
.then(res => console.log('compress success', res))
.catch(err => console.log('compress fail', err));

2. 检查异步执行逻辑
   如果代码运行在HTTP接口、云函数（比如Lambda）等环境中，必须等待该Promise执行完成再返回响应，否则执行环境会提前销毁，导致没有日志输出：

• Express/Koa 等Web框架中，要在then/catch回调内再返回接口响应
• Lambda 中需要把整个Promise链return出去，不要写在无等待的同步逻辑后

3. 核对入参结构
   确认jobTemplate对象结构符合API要求，必填字段不能缺漏：

• 自定义任务参数必须包含Role、Queue、Settings三个顶级字段
• 如果引用已存储的JobTemplate，需要显式传入JobTemplate字段指定模板的ARN/名称，不要和自定义参数结构混用

4. 补充权限校验
   确认调用接口的IAM身份有mediaconvert:CreateJob权限，同时任务使用的Role ARN的信任策略已添加mediaconvert.amazonaws.com为可信主体，且Role拥有对应S3输入输出桶的读写权限。

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