PostgreSQL函数从JWT获取ID传参返回null问题排查

问题根源 #

当JWT载荷包含多个字段时current_setting('request.jwt.claim.id')返回null，核心原因是你的JWT中id并非顶级claim字段，current_setting('request.jwt.claim.xxx')仅能直接读取顶级的JWT claim。如果id嵌套在子对象中（比如{"user": {"id": 123}}），就会读取失败返回null；而当载荷只有id时，它处于顶级层级，所以能正常读取。

修复方案 #

方案1：调整JWT结构，将id设为顶级claim #

修改JWT生成逻辑，把id放在载荷的顶级位置，示例结构：

{
  "id": 123,
  "name": "test_user",
  "exp": 1718918400
}

这种情况下你的原函数可以正常工作。

方案2：解析完整JWT payload（适配嵌套场景） #

如果无法修改JWT结构，改用current_setting('request.jwt.claims')获取完整的JWT payload JSON，再通过JSON函数提取id：

CREATE OR REPLACE FUNCTION public.get_entities_test1()
    RETURNS TABLE(education_group integer) 
    LANGUAGE 'plpgsql'
    COST 100
    VOLATILE PARALLEL UNSAFE
    ROWS 1000
AS $BODY$
declare 
myid integer;
jwt_payload jsonb;
BEGIN
  -- 获取完整的JWT payload JSON
  jwt_payload = current_setting('request.jwt.claims', true)::jsonb;
  
  -- 提取id：如果是顶级字段用'{id}'，嵌套场景比如user.id用'{user, id}'
  myid = (jwt_payload #>> '{id}')::integer; 
  -- 嵌套场景示例：myid = (jwt_payload #>> '{user, id}')::integer;

  RETURN QUERY
  SELECT education_group_id from rbac_get_entities( myid );
END
$BODY$;

额外排查步骤 #

• 解码验证JWT结构：在Postman中直接解码JWT，确认id的层级位置
• 测试完整payload读取：执行SELECT current_setting('request.jwt.claims', true);查看返回的JSON内容，确认id存在且路径正确

内容的提问来源于stack exchange，提问作者abhishree kanoj