Postman中Basic Authentication认证失效问题排查

以下是几种常见的原因及排查方向：

• 后端未正确开启Basic Auth支持
  多数后端框架（如Spring Security、ASP.NET Core）默认会将未通过认证的请求重定向到登录页面，而非返回标准的401 Unauthorized。如果你的后端同时配置了表单登录和Basic Auth，表单登录的优先级通常更高，会优先触发重定向逻辑。需要检查后端配置，确保Basic Auth的认证过滤器被正确启用，且优先级高于表单登录规则。

• Postman的Basic Auth配置错误
  仔细核对Postman的认证设置：

  • 确认Auth选项卡选择的是「Basic Auth」类型，而非其他认证方式
  • 检查用户名、密码是否输入正确，注意大小写、特殊字符（如空格、符号）的拼写
  • 可以手动构造Authorization头验证：将用户名:密码进行Base64编码，在Headers中添加Authorization: Basic [编码后的字符串]，重新发送请求观察结果。

• 请求头被Postman自动篡改
  如果之前用Postman测试过表单登录，可能会保留相关Cookie，导致后端优先使用会话认证而非Basic Auth。可以在Postman的「Headers」选项卡中删除多余的Cookie头，或开启「Send no cookies」选项后重新测试。

• 后端接口权限配置错误
  确认/users接口的权限规则是否正确：该接口是否确实接受Basic Auth认证，还是仅允许已通过表单登录的会话访问。如果后端将该接口配置为仅支持会话认证，即使Basic Auth凭证正确，也会被重定向到登录页。

• 后端对请求客户端类型的判断
  部分后端会区分浏览器请求和API请求：对浏览器返回重定向，对API请求返回401。如果Postman的User-Agent头被识别为浏览器类型，就会触发重定向。可以修改Postman的User-Agent头为非浏览器值（如PostmanRuntime/7.29.0）后重试。

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