Artifactory点击「URL to file」时webinterface返回400 Bad Request求助

1. 排查URL格式问题 #

• 检查复制的「URL to file」链接是否存在多余转义字符、空格，或者被剪切板、浏览器自动截断的情况，重点校验链接中的仓库名、文件路径是否与Artifactory内实际路径完全一致，注意Artifactory对文件路径大小写严格匹配
• 如果文件名包含中文、空格、&/%/#等特殊符号，确认链接中的特殊字符已被正确URL编码，未编码的特殊字符会直接触发400错误

2. 排查权限与会话问题 #

• 确认当前登录账号拥有目标文件所在仓库的读取权限，部分场景下权限不足时Artifactory会返回400而非403错误，可尝试退出重新登录、清除浏览器缓存后再测试
• 如果你使用的是匿名下载链接，需确认Artifactory后台已开启对应仓库的匿名访问权限，且匿名用户组配置了对应路径的读取权限

3. 排查服务端配置问题 #

• 若你部署了Nginx/Apache作为Artifactory的前置反向代理，检查代理配置：
  • 确认client_max_body_size配置值大于待下载文件大小
  • 确认large_client_header_buffers配置足够承载长路径请求，默认配置过小会拦截长路径下载请求返回400
  • 确认X-Forwarded-*系列请求头的传递格式符合Artifactory要求，错误格式的请求头会触发Artifactory的请求校验规则返回400
• 查看Artifactory服务端日志定位具体原因，日志路径为$JFROG_HOME/artifactory/var/log/artifactory-service.log，搜索对应请求的400错误记录，日志会明确标注Invalid path character/Path too long等具体错误原因

4. 适配版本已知问题 #

• Artifactory 7.25.7属于较早的7.x迭代版本，存在「URL to file」链接生成编码错误的已知问题，你可以手动修改链接格式测试：将原链接中的/api/download/路径替换为/artifactory/后拼接仓库名+完整文件路径，示例格式为https://你的Artifactory服务地址/artifactory/目标仓库名/文件完整路径

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