ADALO中按钮调用C# API返回500内部服务器错误问题咨询

已知前提：C# 编写的SQL Server增改API在Postman、Adalo自定义操作样例测试场景下均调用正常，仅按钮点击触发同接口、同业务样例参数时返回500错误，优先排查两类场景的隐式差异，不要重复验证已经通过的业务逻辑。

一、请求链路差异排查 #

• 跨域配置问题：Adalo样例测试是平台服务端发起请求，不存在跨域限制；按钮点击是用户浏览器端发起请求，会先发送OPTIONS预检请求。如果你的C# API没有放行OPTIONS方法，预检请求会直接进入业务逻辑层，触发空引用、参数缺失类异常返回500。
• 请求头差异：对比两类请求的完整请求头，重点核查：
  • Content-Type是否一致：样例测试默认带application/json头，按钮触发时如果配置错误可能传text/plain或表单类型，导致C#反序列化失败
  • 鉴权头是否透传：如果接口做了Token鉴权，检查按钮动作配置里是否把鉴权头绑定到了全局变量，不要只在自定义操作的样例配置里填固定Token
  • 自定义上下文头是否缺失：部分接口会依赖头里的来源标识、租户ID字段，样例测试时平台自动补全的头不会自动同步到按钮触发的请求里
• 出口IP限制：如果API配置了IP白名单、WAF规则，Adalo服务端测试的出口IP在白名单内，但端上触发的请求如果走端侧代理、或者出口IP不在白名单，网关层可能直接返回500而非403。

二、参数传递差异排查 #

• 隐式类型转换问题：不要只看参数值字面量一致，要抓原始请求体对比：Adalo按钮触发时会把页面组件的字段值做自动类型转换，比如数字类型值转成带引号的字符串、日期字段转成本地化格式字符串，C#强类型反序列化时类型不匹配会直接抛异常。
• 隐式空值问题：样例测试时你手动填的参数是全量赋值，但按钮触发时如果某个参数没有正确关联到页面组件值，会默认传null，如果你的SQL插入/更新逻辑没有做参数非空校验，会触发数据库非空约束、空引用异常返回500。
• 参数被覆盖问题：检查按钮点击的动作链，如果自定义操作前配置了其他赋值、跳转动作，可能会把你预设的样例参数动态替换成其他值，配置页看到的静态参数值不等于实际运行时的传值。

三、运行上下文差异排查 #

• 环境同步问题：如果是在Adalo预览环境测试按钮，检查自定义操作的最新配置是否同步到预览版，未发布的配置改动可能不会在预览端生效，实际调用的是旧版错误配置。
• 数据库鉴权上下文问题：如果API用了集成身份验证、短期令牌连接SQL Server，检查按钮触发时连接令牌是否过期、当前请求携带的用户标识是否有对应表的增改权限，不要默认SQL连接配置永远有效。
• 全局异常捕获临时埋点：在C# API的请求管道最外层加全局异常中间件，把所有500错误的完整异常堆栈、原始请求体、请求头全量落日志，这是最快定位根因的手段。

注意：不要重复用Postman验证正常逻辑，500错误一定是两类触发场景的隐式差异导致的，所有排查动作都围绕"两种请求的不一样"展开，不要靠猜测排查问题。

内容的提问来源于stack exchange，提问作者Emanuele Giuliani