DexSQL 表与视图参考

本文说明每个内置关系的一行代表什么、连接键、字段含义和可空性。日常分析优先使用已解析的视图；检查 DEX 结构时使用基础表。

? 表示可空列。Utf8、Utf8View 和字符串字典在 SQL 中都作为文本使用；Dynamic 可以容纳不同 SQL 值类型。索引以 file_id 为作用域，字符串除外，其键为 (string_pool_id, string_idx)。序号从 0 开始。_off 表示字节偏移，指令地址以 16 位 code unit 计量。

文本以原始 MUTF-8 存储，在输出边界解码，详见文本值。目录中的 Utf8 类型名表示 SQL 文本，不表示内部字节编码。

查看当前程序的 schema 可使用 dexsql tables --input app.apk 或 MCP 的 list_tables / describe_table。

选表指南

实体视图

types

一行是当前 dex 引用的一个类型（type_ids 的一项）。

protos

一行是当前 dex 引用的一个方法原型（proto_ids 的一项）。

参数按 DEX 顺序排列。无参数时 param_count = 0、param_descriptors = ''。

fields

一行是当前 dex 引用的一个字段（field_ids 的一项）。这是引用关系，不是定义关系——参见引用与定义；某个类自己声明的字段用 class_fields。

methods

每行对应一个 DEX 引用的方法 ID，无论该 DEX 是否定义了这个方法。键为 (file_id, method_idx)；同一 descriptor 可以在多个 DEX 中出现。

仅引用行的 access_flags、method_kind、opcode_count 和 opcode_hex 为 NULL：该 DEX 并未定义这个方法，其字节码（如有）在别的文件中。已定义但没有 code item 的方法（abstract 或 native）的 opcode_count = 0、opcode_hex = ''。方法定义见 class_methods。

classes

每行对应一个类定义。只被引用的类型位于 types，不出现在此处。superclass_descriptor 和 source_file 可以为空。interface_count 是直接声明的接口数量，接口名称见 class_interfaces。

引用与成员视图

method_strings

一行是一条引用字符串的指令：某个方法中的一处字符串常量。同一方法多次引用同一字符串会有多行。

method_calls

每行对应一条方法调用指令。无前缀列描述调用方，callee* 列描述指令引用的目标。重复调用保留为多行，不自动展开 override 或运行时分派。查询写法见调用查询。

method_field_accesses

每行对应一条字段访问指令。using_type 使用小写：get 表示读取，put 表示写入。方法列标识访问方，字段列标识被引用的字段。

method_used_types

一行是一条引用类型的指令（check-cast、new-instance 等）。

method_using_numbers

每行对应一条加载数值立即量的指令。long_value 保存符号扩展的整数或浮点原始位；double_value 保存数值形式的浮点值，byte/short 常量对应 NULL。

proto_params

一行是某个原型的一个参数。与 protos.param_descriptors 是同一份数据的两种形态：这里一个参数一行，那里拼成一个字符串。

class_methods

每行对应 class data 中的一个方法定义，键为 (file_id, method_idx)。包含 direct、virtual 方法以及 abstract/native 声明。更多原型和 opcode 字段可通过相同键在 methods 中读取。

class_interfaces

每行对应类或接口直接声明的一个接口关系，不展开继承得到的接口。未直接声明接口的类型在此处没有行。

annotation_elements_resolved

每行对应一个 owner、注解和顶层元素。没有元素的标记注解仍产生一行，元素列为 NULL。同一注解被多个 owner 共享时，会分别产生对应行。

retention_policy 将 visibility 0/1/2 映射为 class/runtime/system。owner_kind 为 class、field、method 或 parameter。嵌套元素见 annotation_values。

annotation_values

每行对应一个 owner 和任意嵌套深度的编码值节点。没有元素的标记注解不产生行。不含 owner 的值树位于 annotation_elements；节点字节范围和原始 value_index 引用也在该表。示例见注解查询。

字符串与注解

strings

每行对应一个字符串池条目，包括常量、名称和 descriptor。value 保留原始 MUTF-8，可直接用 WHERE value = '…' 或 WHERE value LIKE '%needle%' 过滤。

class_fields

一行是一条字段定义（某个类的 class-data 成员）。这是 fields 的定义侧对应物，关系与 class_methods 之于 methods 相同——参见引用与定义。列名同样带 field_ 前缀：field_name / field_descriptor 对应 fields 的 name / descriptor。

annotations

每行对应一个 DEX annotation_item，唯一键为 (file_id, annotation_off)。表本身不带 owner 列，多个 owner 可以通过注解集合引用同一项。owner 关系见注解视图，值见 annotation_elements。

annotation_elements

每行对应一个编码值节点，唯一键为 (file_id, annotation_off, value_off)。depth = 0 表示顶层元素。直接子节点的深度增加 1，字节范围位于父节点的 [value_off, value_end_off) 内。共享注解项在此只保存一份。

DEX 文件布局

dex_files

每个逻辑 dex 一行。APK/ZIP 中每个 classes*.dex 都会成为独立行；DEX 041 容器里的每个逻辑 dex 也各占一行。

map_items

暴露 dex map_list。它描述当前 dex 内各 section 的类型、大小和起始偏移。

id_items

统一暴露各类 id section 的原始 item 偏移。适合做底层布局检查。

索引与类数据

type_ids

原始 type_ids 段：每个类型一行，只存其 descriptor 的 string id。可读的 types 视图基于这张表。

type_lists

原始 type_list 结构的摘要。proto 参数列表和 class interface 列表都会引用它。

type_list_entries

把每个 type_list 拆成逐项行。

列表按偏移共享，方法原型参数和类接口可以引用同一份列表。

proto_ids

原始 DEX proto_id_item 行。可读文本与参数聚合位于 protos 视图。

field_ids

原始 field_ids 段：每个 field id 一行，只存 DEX 实际保存的三个索引。可读的 fields 视图基于这张表。

method_ids

原始 method_ids 段：每个 method id 一行，只存 DEX 实际保存的三个索引。可读的 methods 视图基于这张表。

class_defs

原始 class_def_item 记录——只有 DEX 索引，每个已声明的类一行，按 class-def 记录顺序排列。这些索引的 可读名称见 classes 视图；这里保留的是寻址该类其它结构所需的 offset。

class_data_items

类 class_data_item 摘要，记录字段和方法分组数量及字节范围。

class_data_methods

一行是 class-data 中的一条方法定义，带访问标志和它所属的编码列表（direct / virtual）。本 dex 只引用而未定义的 method_id 在这里没有行——这就是 methods.access_flags 与 methods.method_kind 可空的来源，参见引用与定义。带类和方法名的可读形式用 class_methods 视图。

class_static_values

类静态字段初始值。它把 static_values_off encoded array 按顺序映射回静态字段。

方法句柄与调用点

method_handles

DEX 038+ 的 method_handle_item 表：handle 类型 + 它寻址的成员索引。

call_sites

DEX 038+ 的 call_site_id_item 摘要，解析 invoke-custom 的 bootstrap 信息。

call_site_args

把 call site encoded array 的每个 encoded value 拆成逐项行。

这里只列顶层值。嵌套值树位于 encoded_array_values，其 encoded_array_off = call_site_off。

编码值

encoded_arrays

所有已发现的 encoded_array_item 摘要。

encoded_array_values

每行对应编码数组中的一个值节点。depth = 0 表示顶层项；深度和字节范围包含关系描述嵌套数组及注解。引用名称按 value_kind 指定的索引域解析。

encoded_array_owners

把 encoded array 偏移关联回已知 owner，例如 class static values 或 call site。

hiddenapi_flags

Android hidden API metadata。只在 dex 携带对应 hiddenapi 数据时有行。

代码与异常处理

code_items

方法实现的 code_item header 和布局信息。

try_items

方法 code_item 中的受保护指令范围。

catch_handlers

展开 encoded_catch_handler_list 中的 typed catch 和 catch-all 条目。

调试信息

debug_info

方法级 debug_info_item 摘要。

debug_parameters

debug header 中的方法参数名。

debug_positions

debug 状态机产生的源码位置映射。

debug_locals

debug 状态机中的 local variable 事件。

debug_opcodes

逐条暴露 debug 状态机字节码，以及执行该 opcode 后的状态。

注解结构

annotation_directories

类 annotation directory 的摘要。

annotation_directory_entries

annotation directory 中 field、method、parameter 三类 entry 的统一展开。

annotation_sets

原始 annotation_set_item 摘要。

annotation_set_entries

把 annotation set 拆成逐 annotation 引用行。

annotation_set_ref_lists

参数 annotation 使用的 annotation_set_ref_list 摘要。

annotation_set_refs

把参数 annotation ref list 拆成逐参数位置行。

字节码引用与摘要

method_refs

方法字节码中的低层稀疏引用表。每行代表某个方法中一条带 dex 索引引用的指令。它保留引用类型和原始索引，不负责把目标解析成字符串、字段或方法 descriptor。普通特征查询优先使用语义视图（string 类型用 method_strings，method 类型用 method_calls，field 类型用 method_field_accesses，type 类型用 method_used_types）。

method_numbers

方法字节码中立即数常量的低层逐指令表——method_using_numbers 视图的原始来源。每行代表一条加载常量的指令；与 method_refs 不同，其数值是指令固有的，而非 dex 索引引用。特征查询优先使用 method_using_numbers 视图，它会解析出使用方方法的 descriptor。

method_opcodes

按 (file_id, method_idx) 标识的方法 opcode 摘要，每个 method_ids 行一行，为 methods 的 opcode 列提供数据。需要准备 opcode 数据。本 dex 只引用的方法两个 opcode 列均为 NULL；已定义但没有 code item 的方法为 0 / ''。

Copyright (c) 2026 LSPosed Developers。本文档采用 MIT 许可证。