KernelSU中WEBUI API的spawn方法问题解析

问题背景

KernelSU是一个基于内核的Android超级用户权限管理工具，它提供了WEBUI API供开发者使用。其中spawn方法用于创建子进程并执行命令，类似于Node.js中的child_process.spawn。但在实际使用中发现，该方法在某些情况下无法正常工作。

问题现象

开发者在使用WEBUI API的spawn方法时，按照官方文档示例编写了如下代码：

import { spawn } from 'kernelsu';

const ls = spawn('ls', ['-lh', '/data']);

ls.stdout.on('data', (data) => {
  debugger;
  console.log(`stdout: ${data}`);
});

ls.stderr.on('data', (data) => {
  debugger;
  console.log(`stderr: ${data}`);
});

ls.on('exit', (code) => {
  debugger;
  console.log(`child process exited with code ${code}`);
});

代码中添加了debugger断点，但在MIUI和原生安卓系统上测试时，都无法进入断点，表明spawn方法没有按预期工作。

问题原因分析

从错误日志中可以发现关键报错信息：

org.json.JSONException: Value ["-lh","\/data"] of type org.json.JSONArray cannot be converted to JSONObject

这表明在KernelSU内部处理spawn方法的参数时，尝试将一个JSON数组转换为JSON对象，导致了类型不匹配的异常。具体来说：

1. 开发者传入的参数['-lh', '/data']是一个数组
2. 但KernelSU内部代码期望这是一个JSON对象
3. 这种类型不匹配导致方法执行失败

技术解决方案

该问题已在KernelSU的1.0.7版本中修复。修复方案主要涉及：

1. 修改参数处理逻辑，正确处理数组类型的参数
2. 确保参数传递过程中保持正确的JSON格式
3. 完善错误处理机制，提供更清晰的错误提示

开发者应对建议

对于遇到此问题的开发者，可以采取以下措施：

1. 升级到KernelSU 1.0.7或更高版本
2. 在等待升级期间，可以尝试将参数格式改为对象形式（如果API支持）
3. 检查错误日志，确认是否是相同的JSON转换问题
4. 考虑添加try-catch块捕获可能的异常

总结

KernelSU的WEBUI API提供了强大的系统交互能力，但在早期版本中存在参数处理不够完善的问题。通过分析错误日志和理解底层机制，开发者可以更好地诊断和解决这类问题。随着项目的持续更新，这类API边界条件问题会得到更好的处理。