从v2.1升级至v3.0后PUT配送地址接口返回401 Unauthorized问题咨询
升级v3.0后配送地址设置接口返回401的排查指引
核心问题现象
- 从v2.1版本升级至v3.0版本后,调用
PUT /users/current/carts/{validId}/addresses/delivery?addressId={validId}接口返回401 Unauthorized错误 - 该请求由
occ-checkout-delivery.adapter.ts内置的setAddress()方法触发,业务侧未对该方法做任何重写
需逐一排查的遗漏适配步骤
- 游客购物车权限规则适配:v3.0版本将游客匿名授权的处理逻辑从OCC适配器层迁移到了全局请求拦截器,非登录态下的游客购物车操作不再默认携带匿名授权头。需检查项目内的购物车持久化逻辑,是否正确保留了游客用户标识,避免请求被判定为需要登录态触发401
- 授权拦截器规则配置:v3.0新增了基于OCC请求路径的授权头匹配逻辑,需检查
OccConfig中的授权规则配置,确认该PUT接口的路径规则被纳入允许非登录态访问的范围,避免拦截器强制要求携带登录用户的access_token - 购物车归属校验逻辑:v3.0内置的购物车校验服务会自动匹配请求携带的购物车ID与当前有效授权凭证的归属关系。需确认升级后未移除购物车初始化时同步关联授权凭证的逻辑,避免本地存储的购物车ID与有效凭证不匹配触发401
- 跨域凭证配置:若升级过程中调整了静态资源部署域名、OCC服务跨域规则,需确认跨域配置已开启
Access-Control-Allow-Credentials,否则浏览器会拦截请求中的授权头,后端无法获取有效凭证直接返回401
完成上述配置排查后,可通过浏览器开发者工具检查该接口的实际请求头,确认是否携带了有效的授权凭证;若请求头确实缺失,可进一步排查自定义请求拦截器是否在升级过程中残留了旧版本的覆盖逻辑,导致授权头未正确注入。
内容的提问来源于stack exchange,提问作者PascalAOMS
相关产品推荐
相关产品推荐

