ToolJet 里的查询报错或者返回空先不要改 SQL 结构也不急着换数据源。打开运行面板看这一次执行的原始错误再把问题落到两个位置上参数有没有真的传进去、传进去的值和数据库字段类型对不对得上。这两处覆盖了日常遇到的大部分情况而且都能通过页面行为、配置项和日志直接验证不需要靠猜。查询失败时先在运行面板抄下完整错误原文用它判断错误发生在参数绑定阶段、SQL 执行阶段还是结果映射阶段。提示里出现列名、表名、操作符通常说明参数已经传到数据库层出现参数数量、空值、未定义之类字眼先查传参。分不清时把动态参数换成一个写死的静态值跑一次两次结果一比就知道问题在哪一层。不同数据源和驱动版本的报错文本不一样以实际日志为准。在运行面板读到完整错误信息并抄下原文一次查询跑完运行面板给出的线索通常有两类执行状态成功、失败、超时、仍在运行以及数据源返回的原始内容。不同版本的入口位置和折叠方式略有差异一般是点开查询编辑器下方的运行结果区或者展开右侧面板里的响应与错误折叠箭头就能看到完整文本。展开后不要只读第一行把整段复制到编辑器里再看。错误文本一般可以拆成三部分来读状态码或错误类别例如连接被拒、权限不足、语法错误、类型错误、超时。一句提示语通常直接说明原因例如找不到列、操作符不适用、参数个数不符。涉及的具体对象往往是字段名、表名、占位符序号或操作符。如果提示里出现了具体的列名或表名说明语句已经到达数据库层参数绑定这一环大概率是通的如果提示里是参数数量、未定义、空值这类字样优先怀疑绑定阶段。抄写时建议连查询名、使用的数据源、报错时的参数值、错误堆栈首段一起记下来后面做对照时这几项能帮你区分两次运行。确认查询参数在组件里已被赋值参数为空和参数值错误在运行面板里的表现并不一样但都很容易被当成「查询没数据」。参数为空绑定的表达式没取到值常见原因是组件名写错、组件尚未渲染、字段名不对。条件恒不成立查询往往不报错只是返回空结果。参数值错误值确实传进去了但和你以为的不是同一个例如下拉框传的是显示文本而不是值多选组件传的是数组而不是单个值表达式返回的是字符串而字段是数字。参数面板里常见的两种写法如下放在查询编辑器的参数区使用-- 写法一在 SQL 里直接绑定 select id, status, created_at from orders where status {{components.statusSelect.value}} and customer_id {{components.customerInput.value}} -- 写法二SQL 用占位符参数在参数面板定义 select id, status from orders where status $1 and customer_id $2 -- 参数面板 -- status - {{components.statusSelect.value}} -- customer_id - {{components.customerInput.value}}两种写法都可以关键是参数面板里的值有没有被求值。判断办法是临时建一个只返回参数本身的查询例如select {{components.statusSelect.value}} as probe运行后看运行面板返回什么也可以把参数值显示在一个文本组件上。看到未定义、空字符串、数组形式的值问题就在传参这一层不必再改 SQL。核对传入值与数据库字段类型是否匹配参数确实传进去了报错依旧存在就往类型上查。常见的类型不匹配现象有这些数值列和字符串参数比较或字符串列和数字参数比较数据库无法直接比较通常提示操作符或类型不适用。日期、时间列收到字符串格式或时区对不上可能报转换失败也可能不报错但一行都匹配不到。布尔列收到文本形式的真假值或者收到数字 0 和 1。状态、枚举列收到大小写不一致的值例如传入 Active库里存的是 active。把数组传给单值占位符或者把单个值传给需要列表的位置。修正方向一般是三选一在 SQL 里显式转换把参数转成数值或日期类型再比较在参数面板里转换把组件值转成目标类型后再绑定或者回到查询设计让占位符类型和列类型对齐。具体驱动会报什么错、错误文本长什么样不同数据源和版本并不一致需要以运行面板里的实际日志为准不要拿别人的错误码直接对号入座。用静态值替换动态参数做一次对照这一节的目的是把问题锁死在「动态传参路径」上。操作步骤如下先复制一份原查询保留一份可回退的版本不要直接改原查询。在副本里把绑定表达式替换成一个明确的静态值值要和「动态值本应等于的结果」完全一致包括引号、大小写、日期格式和时区。用同样的入口触发运行比较两次结果错误文本是否相同、返回行数是否一致、关键字段的值是否一致。把差异点记下来再决定回到第 2 节查传参还是留在本节继续查 SQL 和字段。结果对照的判断方式静态值正常、动态值报错问题在传参路径重点看组件名、取值方式、参数面板绑定以及组件在运行时是否已经渲染静态值也报错问题在语句本身或字段类型两次都不报错但结果不同说明实际传进去的值和你以为的不一样回到参数实际值那里确认。把修正后的查询保存并在预览页复核改完查询先保存再切到应用的预览模式用接近真实用户的路径复现一次先在下拉框里选择再在输入框里填值然后点触发查询的按钮观察页面上的变化。预览页需要重点看的几项表格或列表组件有没有数据行数是否合理空值是整列为空还是个别字段为空。数值、日期字段的显示是否正常有没有出现类似非法日期的占位文本。触发按钮的状态是否一直停在加载中、是否被禁用、点击后是否重复触发查询。运行面板在预览模式下是否还输出错误。组件的默认值在用户还没有手动选择之前参数是什么页面加载时是否已经跑过一次查询并失败。如果编辑器里调试通过、预览页仍然报错多半是预览环境下的组件状态、默认值或数据源权限与编辑器不同。这时先用同样的静态值再对照一次确认是传参差异还是权限差异确认无误后再保存应用版本。整个排查顺序不变先读原始错误再查参数赋值然后核对字段类型最后用静态值对照并在预览页复核。