Java 8+NetBeans 16部署WAR至Tomcat时遇NoSuchMethodError求助

环境：Java 8、NetBeans 16、Tomcat
部署任意WAR包时抛出以下错误：

In-place deployment at E:\Web_Project\WebApplication1\build\web
E:\Web_Project\WebApplication1\nbproject\build-impl.xml:1030: 
java.lang.NoSuchMethodError: java.net.URLEncoder.encode(Ljava/lang/String;Ljava/nio/charset/Charset;)Ljava/lang/String;
    at org.netbeans.modules.tomcat5.deploy.TomcatManagerImpl.createTempContextXml(TomcatManagerImpl.java:361)
    at org.netbeans.modules.tomcat5.deploy.TomcatManagerImpl.initialDeploy(TomcatManagerImpl.java:196)
    at org.netbeans.modules.tomcat5.optional.TomcatIncrementalDeployment.initialDeploy(TomcatIncrementalDeployment.java:126)
    at org.netbeans.modules.j2ee.deployment.impl.TargetServer.deploy(TargetServer.java:670)
    at org.netbeans.modules.j2ee.deployment.devmodules.api.Deployment.deploy(Deployment.java:221)
    at org.netbeans.modules.j2ee.deployment.devmodules.api.Deployment.deploy(Deployment.java:141)
    at org.netbeans.modules.j2ee.ant.Deploy.execute(Deploy.java:86)
    at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:292)
    at sun.reflect.GeneratedMethodAccessor80.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:498)
    at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:99)
    at org.apache.tools.ant.Task.perform(Task.java:350)
    at org.apache.tools.ant.Target.execute(Target.java:449)
    at org.apache.tools.ant.Target.performTasks(Target.java:470)
    at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1391)
    at org.apache.tools.ant.Project.executeTarget(Project.java:1364)
    at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
    at org.apache.tools.ant.Project.executeTarget(Project.java:1254)
    at org.apache.tools.ant.module.bridge.impl.BridgeImpl.run(BridgeImpl.java:261)
    at org.apache.tools.ant.module.run.TargetExecutor.run(TargetExecutor.java:573)
    at org.netbeans.core.execution.RunClassThread.doRun(RunClassThread.java:132)
    at org.netbeans.modules.openide.util.GlobalLookup.execute(GlobalLookup.java:45)
    at org.openide.util.lookup.Lookups.executeWith(Lookups.java:278)
    at org.netbeans.core.execution.RunClassThread.run(RunClassThread.java:81)
BUILD FAILED (total time: 0 seconds)

问题成因 #

错误中的java.net.URLEncoder.encode(String, Charset)方法是Java 10才新增的API，而NetBeans 16的Tomcat部署模块（org.netbeans.modules.tomcat5）调用了这个方法。当前使用的Java 8不包含该方法，因此部署时抛出NoSuchMethodError。

解决方案 #

提供三种可行方案，根据自身需求选择：

方案1：升级JDK版本 #

将JDK升级到Java 10或更高版本，推荐使用Java 11（LTS长期支持版）——NetBeans 16官方原生支持Java 11+，升级后即可兼容该API，解决部署错误。

方案2：降级NetBeans版本 #

如果必须保留Java 8，可将NetBeans降级到NetBeans 12.x系列（NetBeans 12是最后完全兼容Java 8的官方大版本），该版本的Tomcat部署模块未使用Java 10+的API，可正常配合Java 8部署WAR包。

方案3：分离NetBeans运行JDK与项目JDK #

无需升级项目的Java 8环境，仅让NetBeans自身运行在Java 10+环境中：

• 安装Java 11（或更高兼容版本）；
• 找到NetBeans安装目录下的etc/netbeans.conf文件；
• 修改netbeans_jdkhome参数，指向Java 11的安装路径（例如：netbeans_jdkhome="C:\Program Files\Java\jdk-11.0.20"）；
• 重启NetBeans，项目的编译、运行仍配置为Java 8，即可正常部署Tomcat。

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