WSO2 IS 5.4.0：SAML断言中用户名属性未正常发送的问题排查

我来帮你一步步排查解决这个问题——既然名字和姓氏都能正常出现在断言里，说明基础的SAML配置是通的，大概率是username相关的声明映射或属性配置细节没到位：

1. 检查服务提供商（SP）的声明配置 #

先登录WSO2 IS管理控制台，定位到你的SAML SP配置项：

• 进入Service Providers > List > 你的SP名称 > Claim Configuration
• 在Requested Claims区域，确认http://wso2.org/claims/username已经被添加，并且勾选了Include in SAML Assertion选项。如果没加，点击Add Claim从列表中找到该声明添加并勾选
• 再检查Local & Remote Claim Mapping：确保SP要求的username（SP端声明名称）已经正确映射到WSO2本地的http://wso2.org/claims/username。如果没有映射，点击Add New Claim Mapping，在Remote Claim URI填SP侧的username，Local Claim URI选择http://wso2.org/claims/username后保存

2. 验证JDBC用户存储的属性映射 #

因为你用的是MySQL用户存储，要确保数据库字段和WSO2声明的映射正确：

• 进入User Stores > List > 你的MySQL用户存储 > Attributes
• 确认Username Attribute设置为你MySQL用户表中存储用户名的字段（比如username或user_id，取决于你的表结构）
• 再检查声明的属性映射：进入Claims > List > http://wso2.org/claims > username，查看Mapped Attribute是否和MySQL用户表的用户名字段完全一致，不一致的话修改后保存

3. 确认用户数据和存储权限 #

• 先在MySQL数据库里直接查询用户表，确认目标用户的用户名字段有有效数据，且WSO2 IS使用的数据库账号有该字段的读取权限
• 再在WSO2控制台的Users and Roles > List > Users里查看该用户的详情，确认Username字段能正常显示。如果这里都看不到数据，优先排查用户存储的连接和权限问题

4. 清理缓存并测试 #

做完配置修改后，一定要清理WSO2的缓存避免旧配置干扰：

• 进入Main > Manage > Cache Management，点击Clear All Caches
• 重新发起SAML登录流程，检查断言中是否已经包含username属性

如果还是不行，可以开启SAML调试日志定位问题：

• 修改<IS_HOME>/repository/conf/log4j.properties，添加配置：log4j.logger.org.wso2.carbon.identity.sso.saml=DEBUG
• 重启IS后，查看<IS_HOME>/repository/logs/wso2carbon.log，搜索SAML断言生成的相关日志，就能找到username属性未被添加的具体原因

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