ExtJS中Ext.Direct加载与提交错误排查方法

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

前端开发

ExtJS中Ext.Direct加载与提交错误排查方法

热心网友时间：2026-06-16

转载

Ext Direct加载和提交过程中常见三个错误：一、启动时抛出数组索引越界异常，这是由于错误使用了@DirectFormPostMethod注解，应替换为@DirectMethod；二、运行时出现受控服务器错误，原因是参数拼接错误，需要分开传递；三、Servlet启动时抛出类找不到异常，这是因为引用缺失。

终于把 Ext.Direct 这块硬骨头啃下来了，说实话在加载和提交过程中踩了不少坑。基础扎实确实能帮大忙，排错时体会尤其明显。下面整理三个典型的 Ext.Direct 加载与提交错误，包括 ArrayIndexOutOfBoundsException、Controlled server error 以及 ClassNotFoundException，希望能帮到正在折腾的朋友。

错误一：启动时抛出 ArrayIndexOutOfBoundsException

严重: StandardWrapper.Throwable
ja va.lang.ArrayIndexOutOfBoundsException: 1
at com.softwarementors.extjs.djn.api.RegisteredStandardMethod.isValidFormHandlingMethod(RegisteredStandardMethod.ja va:53)
at com.softwarementors.extjs.djn.scanner.Scanner.scanAndRegisterActionClass(Scanner.ja va:206)
...

这个异常通常指向一个常见问题：注解使用不当。排查后发现元凶是 @DirectFormPostMethod 注解。将其替换为 @DirectMethod，同时删除由 @DirectFormPostMethod 生成的 import 语句——import com.softwarementors.extjs.djn.config.annotations.DirectFormPostMethod;，问题即可解决。

错误二：运行时报 "Controlled server error"

ERROR: com.softwarementors.extjs.djn.router.processor.standard.json.JsonRequestProcessor - "(Controlled) server error: 1 for Method 'FormAction.submitData'" (rid=1000)
ja va.lang.ArrayIndexOutOfBoundsException: 1
at com.softwarementors.extjs.djn.router.processor.standard.json.JsonRequestProcessor.checkJsonMethodParameterTypes(JsonRequestProcessor.ja va:352)
...

这次是控制层出错，说明逻辑层面有问题。放心，这并非 xml 配置问题，而是传入的参数不匹配。重点在于参数传递的语法细节。排查后发现，Java 接口要求传入两个参数——public Info submitData(String name,String password)，但 ExtJS 端实际传入的参数被拼接成一个字符串：var params= username.getValue()+Password.getValue(); FormAction.submitData(params,function(result,e){}。修改并不复杂，只需将参数分开传递：FormAction.submitData(username.getValue(),Password.getValue(),function(result,e){}。

错误三：Servlet 启动时报 ClassNotFoundException

FATAL: com.softwarementors.extjs.djn.servlet.DirectJNgineServlet - "Unable to find class 'com.softwarementors.extjs.djn.test.config.GsonBuilderConfiguratorForTesting'"
com.softwarementors.extjs.djn.servlet.ServletConfigurationException: Unable to find class 'com.softwarementors.extjs.djn.test.config.GsonBuilderConfiguratorForTesting'
...

原因非常直接——那个类根本不存在。该配置在 web.xml 中被引用，如果只是在测试环境下使用且实际不需要，直接删除相关配置即可：


    registryConfiguratorClass
    com.softwarementors.extjs.djn.test.servlet.config.RegistryConfiguratorForTesting


    gsonBuilderConfiguratorClass
    com.softwarementors.extjs.djn.test.config.GsonBuilderConfiguratorForTesting

以上三个坑基本囊括了 Ext.Direct 加载与提交过程中的常见问题，对照排查即可快速解决。

ExtJS下 Ext.Direct加载和提交过程排错小结