Ubuntu服务器使用Bitbucket Server Backup Client备份报错如何解决

你遇到的报错本质是备份客户端无法和Bitbucket服务器完成合法交互，即使你已经确认基础参数正确，也可以通过以下步骤逐一排查解决：

排查解决步骤 #

• 确认备份客户端和Bitbucket服务器版本匹配：不同版本的Bitbucket要求使用对应版本的备份客户端，版本不兼容是触发这类报错的最常见原因，即使账号密码填写完全正确也会出现鉴权失败、接口调用异常的问题，你可以在Bitbucket官方下载页找到和你当前服务器版本对应的客户端安装包。
• 检查账号权限：确认你使用的账号属于全局管理员组，仅有项目、仓库管理员权限的账号无法调用备份相关的服务端接口。
• 检查API访问设置：登录Bitbucket管理后台，进入「全局设置」-「应用程序」-「API访问」，确认「禁用API访问」选项没有被勾选，同时IP访问限制规则没有拦截你执行备份命令的机器IP。
• 检查路径权限：执行命令的系统用户需要对命令中填写的bitbucket.home和backup.home两个路径都有读写权限。Linux环境可通过ls -l命令查看路径权限，使用chown、chmod调整为当前执行用户可读写；Windows环境需右键打开文件夹属性，在安全标签页给当前用户开放完全控制权限。
• 确认Java版本符合要求：备份客户端仅兼容Java 8和Java 11版本，使用更高版本的Java会出现参数识别、类加载异常，你可以执行java -version命令查看当前使用的Java版本，不符合要求的话更换适配版本即可。
• 特殊字符转义检查：如果你的账号密码、路径中包含空格、&、!等特殊字符，需要根据你使用的操作系统做对应转义：Linux环境下用单引号包裹带特殊字符的参数，Windows环境下用双引号包裹，避免特殊字符被系统自动截断导致参数识别错误。

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