Terraform插件框架自定义Provider中null状态未被检测的问题求助

核心原因 #

你遇到的问题主要来自两个点：

1. Schema的Optional+Computed组合行为：当字段同时设置Optional: true和Computed: true时，Terraform插件框架会将用户设置的null解读为「保留当前已有值」，而非主动清除该值。因此计划阶段不会将someVar标记为null变更，而是沿用状态中的旧值。
2. 模型字段类型错误：如果你的myResourceModel中someVar使用的是原生int64类型而非框架提供的types.Int64，则无法正确表示null状态，导致isNull()始终返回false。

分步解决方案 #

1. 修正模型字段类型

确保模型中的someVar使用Terraform插件框架的可空整数类型types.Int64，而非原生int64：

type myResourceModel struct {
    SomeVar types.Int64 `tfsdk:"someVar"`
}

2. 调整Schema配置

根据你的业务需求选择以下两种方式之一：

方式一：不需要API自动计算值（用户设置什么就是什么）

如果someVar仅由用户控制，不需要API返回默认值，直接移除Computed: true：

"someVar": schema.Int64Attribute{
    Optional: true,
    Validators: []validator.Int64{
        int64validator.Between(1, 1000),
    },
},

此时用户设置someVar = null会被框架正确识别为变更，计划阶段能检测到值的变化。

方式二：需要保留Computed: true（用户不设置时API返回默认值，但允许主动设为null）

如果需要API在用户未设置时返回默认值，但同时允许用户主动设置null来清除该值，需添加自定义PlanModifier覆盖框架的默认行为：

首先定义自定义PlanModifier：

func someVarNullPlanModifier() planmodifier.Int64 {
    return someVarNullPlanModifier{}
}

type someVarNullPlanModifier struct{}

func (m someVarNullPlanModifier) Description(ctx context.Context) string {
    return "强制将计划值设为null，如果用户明确配置了null"
}

func (m someVarNullPlanModifier) MarkdownDescription(ctx context.Context) string {
    return "强制将计划值设为null，如果用户明确配置了null"
}

func (m someVarNullPlanModifier) ModifyPlan(ctx context.Context, req planmodifier.Int64Request, resp *planmodifier.Int64Response) {
    // 检测用户是否在配置中明确设置了null
    if req.ConfigValue.IsNull() {
        // 强制将计划值设为null
        resp.PlanValue = types.Int64Null()
    }
}

然后在Schema中添加该PlanModifier：

"someVar": schema.Int64Attribute{
    Optional: true,
    Computed: true,
    Validators: []validator.Int64{
        int64validator.Between(1, 1000),
    },
    PlanModifiers: []planmodifier.Int64{
        someVarNullPlanModifier(),
    },
},

3. 验证Plan阶段的null检测

修改后，在ResourceWithModifyPlan的逻辑中，plan.someVar.IsNull()就能正确返回true，从而检测到someVar变为null的变更。

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