Jenkins配置只读字符串参数时出现UnsupportedOperationException错误的求助

嘿，这个坑我之前踩过！你提到的WReadonlyStringParameterDefinition并不是Jenkins核心或者官方维护插件里的内置类，所以才会抛出java.lang.UnsupportedOperationException这个错误。下面给你几个靠谱的解决方案，从简单到进阶都有：

方案1：用Extended Choice Parameter Plugin（最省心的方式） #

这是最推荐的方法，不需要写代码，靠官方插件就能实现只读参数：

1. 先在Jenkins插件管理里安装Extended Choice Parameter Plugin
2. 在你的项目参数配置里，选择「Extended Choice Parameter」类型
3. 配置项里做以下设置：
   • Name：填parametro1
   • Default Value：填你想要的默认值parametro1
   • Type：选择「Single Select」
   • Editable：勾选false（关键！这个会把输入框改成不可编辑的下拉框，只能选默认值）
   • Description：可以写上「此参数为只读，不可修改」

这样配置完后，用户在构建页面看到的这个参数就是完全不能修改的，完美符合你的需求。

方案2：自定义只读参数类（适合有开发能力的场景） #

如果不想依赖第三方插件，可以自己写一个简单的参数定义类，继承Jenkins的StringParameterDefinition并重写校验逻辑：

import hudson.model.StringParameterDefinition;
import hudson.util.FormValidation;
import org.kohsuke.stapler.QueryParameter;

public class ReadonlyStringParameterDefinition extends StringParameterDefinition {
    public ReadonlyStringParameterDefinition(String name, String defaultValue) {
        super(name, defaultValue, "只读参数，禁止修改");
    }

    @Override
    public FormValidation doCheckValue(@QueryParameter String value) {
        // 强制参数值必须等于默认值，否则报错
        if (!value.equals(getDefaultValue())) {
            return FormValidation.error("该参数为只读，不允许修改！");
        }
        return FormValidation.ok();
    }
}

把这个类打包成Jenkins插件（.hpi文件）部署到你的Jenkins实例后，就可以在参数配置里使用这个自定义类型了。

方案3：Pipeline项目的运行时校验（折中方案） #

如果是Pipeline项目，也可以用运行时校验的方式来限制参数修改——虽然UI上用户能改，但构建时会直接报错阻止：

pipeline {
    agent any
    parameters {
        string(name: 'parametro1', defaultValue: 'parametro1', description: '只读参数，请勿修改')
    }
    stages {
        stage('参数校验') {
            steps {
                script {
                    if (params.parametro1 != 'parametro1') {
                        error("参数parametro1为只读，不允许修改！当前值：${params.parametro1}")
                    }
                }
            }
        }
        // 后续阶段...
    }
}

这个方法的好处是不需要额外插件，适合快速临时解决问题，但缺点是不能从UI层面阻止修改，只能事后拦截。

内容的提问来源于stack exchange，提问作者Víctor DC