运行正常的Android应用报Elasticsearch:UserIllegalArgumentException错误如何排查

Elasticsearch:UserIllegalArgumentException 本质是Elasticsearch（AWS侧一般为OpenSearch服务）侧收到不符合规范的请求，或请求方权限/身份不符合要求。因无前端React Native代码变更，优先排查服务侧、云资源配置变更：

一、优先排查AWS侧配置变更 #

• 检查OpenSearch服务访问策略：确认是否误删了后端服务出口IP的白名单，是否意外开启了IAM身份验证、精细化权限控制导致原有请求无权限访问目标索引
• 检查索引mapping变更：确认是否有人修改了查询涉及的索引字段类型，比如原有text类型字段被改为date/数值类型，导致原有查询逻辑传入的参数类型不匹配触发异常
• 检查服务版本变更：确认是否开启了OpenSearch自动小版本升级，新版本往往会收紧非规范查询语法的兼容性，旧版本能正常执行的不规范query在新版本会直接抛出参数异常
• 检查服务阈值配置：确认是否调整了查询限制阈值，比如最大返回条数、最大查询时间范围、单query最大复杂度，原有符合要求的查询现在触发阈值拦截

二、请求链路校验 #

• 抓取后端发往OpenSearch的完整查询请求体，和历史正常请求做对比，确认是否存在参数异常（比如用户输入的特殊字符未正确转义，此前无极端输入场景未触发问题）
• 检查后端服务配置：确认连接OpenSearch的访问密钥是否过期，后端服务的ES/OpenSearch SDK是否被意外更新导致默认请求参数变更
• 查看AWS CloudWatch对应时间段的OpenSearch错误日志，日志会明确标注异常的触发根因，比如是permission denied、invalid query syntax还是field type mismatch

三、对应修复方案 #

• 权限/策略类问题：重新添加白名单、调整IAM策略为后端服务授予对应索引的查询权限、更新过期的访问密钥即可
• 索引配置变更问题：回滚索引mapping到历史正常版本，或调整后端查询逻辑适配新的字段类型
• 版本兼容性问题：修改查询语句适配新版本语法要求，或关闭自动小版本升级后回滚到历史兼容版本
• 阈值拦截问题：调整OpenSearch对应查询阈值，或优化查询逻辑降低资源占用避免触发阈值

内容的提问来源于stack exchange，提问作者Ronaldo De La Cruz