使用Node.js连接Azure Storage Emulator创建队列服务时签名错误

我之前也踩过这个坑，这个MAC签名不匹配的问题大多是几个配置细节没处理到位，咱们一步步来排查解决：

• 确认存储模拟器的专属端点
  Azure存储模拟器用的是本地专属端点，不是云服务的标准地址。队列服务的正确本地端点是 http://127.0.0.1:10001/devstoreaccount1，如果你的代码里误用了云环境的端点（比如core.windows.net），直接就会导致签名计算错误。

• 核对密钥的正确性与格式
  你用的devstoreaccount1密钥是模拟器的默认密钥，本身是正确的，但要确保代码里没有不小心修改、多打空格或者特殊字符被转义。另外，部分SDK版本对密钥的编码有要求，直接原样使用即可，不需要额外做URL编码或其他处理。

• 检查SDK与模拟器的兼容性
  如果你的Azure Storage SDK版本太新，可能和旧版模拟器不兼容。比如用v12+的@azure/storage-queue新SDK的话，要确保模拟器是最新版本；或者如果不想升级模拟器，可以降级SDK到适配的版本。

• 优先使用完整连接字符串
  手动拆分账户名、密钥和端点容易出错，更稳妥的方式是直接用模拟器的完整连接字符串：

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;

用这个字符串初始化客户端，能避免很多手动配置的问题。

• 修正后的示例代码
  如果是用新版@azure/storage-queue SDK，代码可以这么写：

const { QueueServiceClient } = require("@azure/storage-queue");

// 模拟器连接字符串
const connectionString = "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;";

async function main() {
  const queueServiceClient = QueueServiceClient.fromConnectionString(connectionString);
  const queueClient = queueServiceClient.getQueueClient("test-queue");
  await queueClient.createIfNotExists();
  console.log("队列创建成功！");
}

main().catch(err => console.error("操作失败:", err));

如果是用旧版azure-storage包，代码示例如下：

const azure = require('azure-storage');

const queueService = azure.createQueueService({
  accountName: 'devstoreaccount1',
  accountKey: 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==',
  queueEndpoint: 'http://127.0.0.1:10001/devstoreaccount1'
});

queueService.createQueueIfNotExists('test-queue', (error) => {
  if (!error) {
    console.log("队列创建成功！");
  } else {
    console.error("错误信息:", error);
  }
});

如果以上都试过还是不行，建议重启一下Azure Storage Emulator，有时候模拟器的状态异常也会导致签名验证失败。

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