跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

评估原因和错误代码

最后更新 查看 MarkdownAgent 设置

当您使用绑定的 *Details 方法或 OpenFeature SDK 评估标志时,响应将包含一个 reason 字段,用于解释返回特定值的原因。如果发生错误,响应将包含一个 errorCode 字段。

评估原因

原因 描述
TARGETING_MATCH 目标定位规则的条件与评估上下文匹配,并返回了该规则的变体。
SPLIT 具有百分比推出的目标定位规则匹配。用户在推出百分比内,并接收了该规则的变体。
STATIC 此功能标志已启用,且没有定向规则,因此返回了默认变体。
DEFAULT 此功能标志有定向规则,但没有规则与评估上下文匹配,因此返回了功能标志的默认变体。
DISABLED 该标志已禁用。无论是否有目标定位规则,都返回了默认变体。
CACHED SDK 返回了缓存的评估结果。
ERROR 评估失败,并返回了默认值。

错误代码

当发生评估错误时,方法将返回您提供的默认值。*Details 方法包含有关错误的附加元数据。

错误代码 描述
TYPE_MISMATCH 标志的变体类型与请求的类型不匹配。例如,在变体为字符串的标志上调用 getBooleanValue。返回默认值。
FLAG_NOT_FOUND 应用中不存在指定的标志键。返回默认值。
INVALID_CONTEXT 上下文结构无效或包含不受支持的值、非有限数字或循环引用,或者超过某项限制。
PARSE_ERROR SDK 收到了无效的评估响应。返回默认值。
GENERAL 评估期间发生了意外错误,例如超时或网络故障。返回默认值。

无效上下文的处理方式

绑定的 *Details() 方法遇到无效上下文时会返回提供的默认值。它们会将 reason 设为 ERROR、将 errorCode 设为 INVALID_CONTEXT,并包含 errorMessage。

直接数据平面 HTTP POST 端点则会返回 400 响应。请求示例请参阅评估 API。

示例

以下示例检查了 getBooleanDetails 返回的评估详细信息:

const details = await env.FLAGS.getBooleanDetails("my-feature", false, {
	userId: "user-42",
});

switch (details.reason) {
	case "TARGETING_MATCH":
		console.log(`Matched targeting rule, variant: ${details.variant}`);
		break;
	case "SPLIT":
		console.log(`Included in rollout, variant: ${details.variant}`);
		break;
	case "STATIC":
		console.log("Flag has no targeting rules, using default variant");
		break;
	case "DEFAULT":
		console.log("No rule matched, using default variant");
		break;
	case "DISABLED":
		console.log("Flag is disabled");
		break;
	default:
		// Handle other reasons, such as "CACHED" or "ERROR".
		break;
}

if (details.errorCode) {
	console.error(`Evaluation error: ${details.errorCode}`, details.errorMessage);
}
const details = await env.FLAGS.getBooleanDetails("my-feature", false, {
    userId: "user-42",
});

switch (details.reason) {
    case "TARGETING_MATCH":
        console.log(`Matched targeting rule, variant: ${details.variant}`);
        break;
    case "SPLIT":
        console.log(`Included in rollout, variant: ${details.variant}`);
        break;
    case "STATIC":
        console.log("Flag has no targeting rules, using default variant");
        break;
    case "DEFAULT":
        console.log("No rule matched, using default variant");
        break;
    case "DISABLED":
        console.log("Flag is disabled");
        break;
    default:
        // Handle other reasons, such as "CACHED" or "ERROR".
        break;
}

if (details.errorCode) {
    console.error(`Evaluation error: ${details.errorCode}`, details.errorMessage);
}

这篇文档对您有帮助吗?