使用jaguar_jwt生成JWT，如何将audience设为字符串而非数组

我来帮你搞定这个问题！因为JwtClaim类的audience字段是final的List?类型，所以没法直接修改它的类型或者赋值为字符串。不过我们可以通过两种方式实现字符串类型的audience：

方法1：直接在otherClaims中定义aud字段 #

JWT标准里的aud（受众）字段本身就支持单个字符串或字符串数组，jaguar_jwt的JwtClaim构造函数的audience参数只是帮你处理数组的情况。我们可以跳过这个参数，直接在otherClaims里手动添加aud键并设置为字符串：

var claimSet = JwtClaim(
  issuer: issuer,
  subject: '',
  // 不要传入audience参数
  otherClaims: {
    'aud': issuer, // 这里直接设置为字符串类型
    'DATA': encodedPayload,
  },
  maxAge: Duration(days: kReleaseMode ? 1 : 7),
);

这样生成的JWT payload里，aud字段就是你想要的字符串类型，而不是数组。

方法2：验证时兼容字符串/数组类型的audience #

如果后续需要验证这个JWT，默认的验证逻辑可能只处理数组类型的audience，所以你需要手动检查aud字段：

final decoded = verifyJwtHS256Signature(token, secretKey);
final audience = decoded.otherClaims['aud'];

// 检查audience是否符合预期
if (audience is String) {
  if (audience != expectedAudience) {
    throw JwtException('Invalid audience');
  }
} else if (audience is List) {
  if (!audience.contains(expectedAudience)) {
    throw JwtException('Invalid audience');
  }
} else {
  throw JwtException('Audience format is invalid');
}

为什么不能直接修改audience？ #

因为JwtClaim类的audience是final属性，没有提供setter方法，而且构造函数只接受List<String>?类型的参数，所以无法通过常规方式将其设置为字符串类型。绕开内置参数，直接操作otherClaims是最直接的解决方案。

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