ios/安卓脚本工具开发按键精灵脚本常见运行时错误与解决方法

按键精灵脚本开发中,运行时错误是最容易出现、也最影响脚本稳定性的问题。很多时候脚本能正常通过语法检查,但一运行就弹出错误提示,让人摸不着头脑。

本文基于官方文档,整理了6 类高频运行时错误,包含错误现象、原因分析、代码示例与一键修复方案,帮你快速定位并解决问题。

错误示例1:函数参数类型错误

复制代码
Dim tableA = {"k1", "v1", "k2", "v2"}, stringA = "searchStr"
TracePrint InStr(1, tableA, stringA)

错误信息:

复制代码
发生运行时错误!错误代码:2,错误行号:2,
错误信息: bad argument #1 to 'LuaAuxLib' (string expected, got table)

错误原因:

第2行调用 InStr 函数时,第二个参数传入了一个 table 类型,但函数期望的是 string 类型。

  • bad argument #1:表示函数的第二个参数(参数序号从0开始)有误。
  • expected:期望的参数类型。
  • got:实际传入的参数类型。

解决办法:

查阅函数文档,确认参数类型要求,并在传参前进行类型和空值检查,避免传入错误类型或 null 值。

错误示例2:对空值进行索引操作

复制代码
Dim tableA = null
TracePrint tableA["k1"]

错误信息:

复制代码
发生运行时错误!错误代码:2,错误行号:2,
错误信息: attempt to index global 'id5441424c4541' (a null value)

错误原因:

尝试对 null 值进行索引操作,导致运行时报错。错误中的变量名为编译后的标识,需要根据行号定位原始代码。

解决办法:

在访问前对变量进行判空处理:

复制代码
Dim tableA = null
If tableA <> null Then 
    TracePrint tableA["k1"]
Else 
    TracePrint "tableA is null"
End If

错误示例3:对布尔类型数据进行连接操作

复制代码
Dim stringA = "stringA",boolA = true
TracePrint stringA & boolA

错误信息:

复制代码
发生运行时错误!错误代码:2,错误行号:2,
错误信息: attempt to concatenate global 'id424f4f4c41' (a boolean value)

错误原因:

尝试将string或number类型数据与bool类型直接拼接。

解决办法:

将bool类型转为string或number类型后再进行连接:

复制代码
Dim stringA = "stringA",boolA = true
TracePrint stringA & cstr(boolA)
TracePrint stringA & cint(boolA)

错误示例4:对字符串类型数据执行算术运算

复制代码
Dim stringA = "1",stringB = "stringB",boolA = true,numberA = 10
TracePrint numberA - boolA
TracePrint numberA - stringA
TracePrint numberA - stringB

错误信息:

复制代码
发生运行时错误!错误代码:2,错误行号:4,
错误信息: attempt to perform arithmetic on global 'id535452494e4742' (a string value)

错误原因:

尝试将string类型数据与number或bool类型数据直接进行算术运算。

在执行算术运算前,按键会自行尝试将数据转为number类型,故代码第2、3行能够正常计算出结果

解决办法:

在执行算术运算前判断数据是否为number:

复制代码
Dim stringA = "1",stringB = "stringB",boolA = true,numberA = 10
TracePrint numberA - boolA
TracePrint numberA - stringA
If IsNumeric(stringB) Then 
    TracePrint numberA - stringB
Else 
    TracePrint cstr(stringB) & " is not number" 
End If

错误示例5:调用不支持的系统函数

复制代码
//在安卓系统中运行:
Dim result, selector
selector = {"type": "UITableViewCellContentView"}
result = iOSElement.Finds(selector)

错误信息:

复制代码
发生运行时错误!错误代码:2,错误行号:4,
错误信息: attempt to call global 'LuaAuxLib' (a null value)

错误原因:

当前系统环境(安卓)不支持调用 iOSElement.Finds 函数,该函数仅在 iOS 系统的新版引擎(v2.3.0及以上)中可用。

解决办法:

查阅函数文档,确认平台兼容性与引擎版本要求,避免在不支持的平台上调用特定 API。

错误示例6:goto跳转穿越变量定义

复制代码
funA
Function funA()
    For i = 1 To 10
        TracePrint i
        If i = 3 Then 
            goto rem1
        End If
    Next
    Dim ret
    Rem rem1
    TracePrint "rem1"
End Function

错误信息:

复制代码
第6行:外部错误:<goto id46554e413a52454d31> at line 6。错误码=13

错误原因:

在函数内部使用 goto 跳转时,不能跨越任何变量定义语句(如 Dim)。否则会引发运行错误。

解决办法:

将所有变量定义提前至函数最开始的位置:

复制代码
funA
Function funA()
    Dim ret
    For i = 1 To 10
        TracePrint i
        If i = 3 Then 
            goto rem1
        End If
    Next
    Rem rem1
    TracePrint "rem1"
End Function

脚本防错通用规范

  1. 变量先判空再使用 :数组、对象、返回值必须先判断<> null;

  2. 类型转换先做再运算:字符串转数字、布尔转字符串;

  3. 函数参数严格对类型:字符串函数不传 table,算术运算不用文本;

  4. 平台先查兼容性:iOS / 安卓 / PC 函数分开调用;

  5. Goto 尽量少用:必须用则保证不穿过 Dim、If、For 等结构。

以上 6 类错误覆盖了50% 以上按键精灵运行时崩溃场景。记住核心原则:类型要匹配、空值要判断、平台要区分、变量要前置,就能大幅减少脚本报错。

相关推荐
wuyk55533 分钟前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
FungLeo3 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks3 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui11 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
茶底世界之下11 小时前
洗衣房的午后斜光:用 Awaking 把光和影分开
ios·app·产品
雨白1 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
我是谁的程序员1 天前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios
开心就好20251 天前
通配符 Bundle ID 和精确 Bundle ID 怎么选,推送、iCloud 能不能用通配符
后端·ios
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m1 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android