开发环境下如何创建可长期使用的localhost版MapKit JS令牌？

近期Apple MapKit JS开始强制要求令牌绑定域名，未绑定域名的令牌会在7天后自动过期；而绑定域名的永不过期令牌又无法直接将localhost设为绑定域名，以下是几种实用解决方案：

方案一：自定义本地域名映射（推荐） #

通过修改本地hosts文件，将你拥有的自定义域名指向localhost，再用该域名创建永不过期的绑定令牌：

• 编辑本地hosts文件：
  • Windows：C:\Windows\System32\drivers\etc\hosts
  • Mac/Linux：/etc/hosts
  • 添加一行：127.0.0.1 dev.yourdomain.com（替换为你自己的域名前缀）
• 登录Apple开发者后台，创建MapKit JS令牌时，将dev.yourdomain.com填入绑定域名字段，生成永不过期的令牌
• 本地开发时，使用dev.yourdomain.com代替localhost访问项目，即可正常使用该令牌

方案二：自动生成临时令牌脚本 #

若不想修改hosts，可编写本地脚本自动生成7天有效期的令牌，集成到开发流程中：

1. 准备好你的Apple开发者私钥（.p8文件）、Team ID和Key ID
2. 用Node.js编写生成令牌的脚本（需先安装jsonwebtoken依赖）：

const jwt = require('jsonwebtoken');
const fs = require('fs');

// 替换为你的实际信息
const privateKeyPath = '/path/to/your/AuthKey_XXXXXX.p8';
const teamId = '你的Team ID';
const keyId = '你的Key ID';

const privateKey = fs.readFileSync(privateKeyPath, 'utf8');
const token = jwt.sign({}, privateKey, {
  algorithm: 'ES256',
  expiresIn: '7d',
  issuer: teamId,
  audience: 'https://maps-api.apple.com',
  header: { kid: keyId }
});

console.log('Generated MapKit Token:', token);

3. 将脚本集成到项目启动命令中，比如在package.json里配置：

"scripts": {
  "start": "node generate-mapkit-token.js && 你的项目启动命令"
}

每次启动项目时会自动生成最新令牌，无需手动操作

方案三：代理转发（备选） #

通过代理服务器将本地localhost的请求转发到已绑定域名的地址，让MapKit JS的请求域名符合令牌绑定要求。该方法配置相对繁琐，适合已有现成代理服务的场景。

注意：开发者私钥属于敏感信息，务必妥善保管，绝对不能上传到公共代码仓库或暴露给第三方。

内容的提问来源于stack exchange，提问作者jävi