DocuSign开发者账号请求authorization code失败无本地回调报错

问题表现 #

• 使用DocuSign开发者账号创建应用后，发起authorization code授权请求，访问授权地址时网页直接报错，未向配置的本地回调地址发起回调
• 发起请求的URL：

https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature&client_id=c4039666-234a-41c9-8593-4d7297573059&redirect_uri=http://127.0.0.1:8000/loan-operation/v1/docusign/callback

• 页面返回错误：The custom error module does not recognize this error，中文译为「自定义错误模块无法识别该错误」，属于DocuSign服务端的通用拦截报错，不会返回具体错误码。

排查解决步骤 #

• 第一优先级核对回调地址完全匹配：DocuSign对回调地址做精确字符串匹配校验，任何字符差异都会直接触发服务端拦截，不会执行回调跳转。逐字符核对你在DocuSign开发者后台对应应用的「Redirect URIs」配置项里填写的地址，和请求URL里的redirect_uri参数值完全一致：
  • 核对协议是http还是https，本地调试用http无影响，但必须和配置完全相同
  • 核对端口号为8000，无错填漏填
  • 核对路径为/loan-operation/v1/docusign/callback，无拼写错误、末尾无多余斜杠
  • 配置修改后等待2-3分钟再测试，后台配置存在生效延迟
• 核对client_id有效性：去后台复制对应应用的Integration Key（即client_id），和请求里的c4039666-234a-41c9-8593-4d7297573059做比对，确认无多抄漏抄字符、无前后多余空格；如果应用刚创建未完成必填基础信息提交，先补全应用信息保存后再测试。
• 排查参数编码问题：不要对请求参数做二次URL编码，比如redirect_uri里的://、/如果被转义为%3A%2F%2F、%2F，服务端解析失败就会报该错误。可以直接把拼好的完整URL复制到浏览器地址栏手动访问，排除代码拼接时的自动编码问题。
• 浏览器环境排查：清理浏览器缓存、打开无痕浏览模式重新访问授权URL，本地存储的过期、损坏的DocuSign登录态Cookie也会触发这类通用报错，无痕模式下如果能正常跳转到登录授权页，清空站点Cookie即可解决。

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