上传慢、上传失败等常见FAQ
| Q1：ak sk 空间名称 和 默认域名是什么？ |
|---|
| 参考文档：存储常见的关键参数 |
| Q2：上传失败，响应非 200 状态码，我应该怎么处理？ |
|---|
| 参考文档：上传失败常见状态码及解决方法 |
| Q3：上传报错 incorrect region Please use up-z(x).qiniu.com ，应该怎么办？ |
|---|
| 报错原因是上传域名与空间所属区域不匹配，目前最新版 SDK 均已支持自动切换区域，所以一般更新 SDK 版本到最新版即可解决。 如果不方便更新版本，可以参照 存储区域和域名的对应关系 ，修改上传域名，或者换一个默认的华东区域的空间。 |
| Q4：上传报错，找不到上传域名，应该怎么办？ |
|---|
| 找不到上传域名，一般来说，是使用的SDK客户端网络异常，不能根据上传token中的ak和bucket信息，调用https://uc.qbox.me/query 和 http://api.qiniu.com/query,去获取空间所在区域的上传域名,从而引发上传慢，耗时长，上传失败找不到上传域名的情况，这种情况，建议SDK直接指定上传域名 或者 region即可,以java为例，其他各个版本SDK参考官方SDK |
//构造一个带指定Region对象的配置类 华东region0，华北region1，华南region2
Configuration cfg = new Configuration(Region.region0());
cfg.resumableUploadAPIVersion = Configuration.ResumableUploadAPIVersion.V2;// 指定分片上传版本
//...其他参数参考类注释
UploadManager uploadManager = new UploadManager(cfg);
//...生成上传凭证，然后准备上传
| Q5：上传报错，qiniup.com域名请求超时ping不通 ，应该怎么办？ |
|---|
| 正常来说，七牛的上传域名 up-z(x).qiniup.com都可以正常ping通，无法ping通的情况，大部分情况下都是客户端网络异常导致，可以常识上传端切换网络，比如从手机网络切换到家庭、公司wifi,看下是否可以；如果还是不可以，常识修改下本地网络的DNS解析服务器，将解析指向114.114.114.114或者8.8.8.8公共DNS，如果不知道怎么修改的话，可以百度下即可，确认网络是否有开启代理，关闭代理后再次测试；在更换网络，关闭代理，修改DNS都无法正常上传的情况下，需要您提供下您的客户端IP 和 ping 的上传节点ip给到工单，然后进行详细排查 |
| Q6：我的客户反馈上传速度慢，我应该提供哪些诊断信息给七牛？ |
|---|
| 1：确认上传端和存储区域是否都在同一区域，如果是国内传海外，或者海外传国内，出现慢的情况符合预期，建议国内传国内，海外传海外 |
| 2：确认下上传端的网络带宽，上行带宽越高，上传速度越快，如果是主机上传，推荐使用客户端上传，客户端的上行带宽一把是远大于服务器代带宽的，可以百度下网络测速，测试上行带宽，上线带宽越高，上传速度越快。 |
| 3：确认网络是否有开代理，如果有开，关闭代理试试 |
| 4：直接在上传代码中，指定上传域名，不使用 autoregion ,减少获取上传域名的耗时 |
| 5：如果以上都不行 参考文档：上传慢如何诊断？ |
| Q7：我上传的文件与预期的不符，有图片变大变小、实际大小不符、图片被压缩、文件不完整等情况。 |
|---|
| 首先 刷新CDN 缓存，刷新完成后，验证文件一致性 。 |
| Q8: 我使用第三方插件，确定填写的参数都是对的，但是一直上传不了文件。 |
|---|
| 七牛官方没有提供过任何插件。官方社区收录的插件，经过验证都是可以使用的，但一般更新不太及时，不会支持七牛的最新功能或产品。 上传报错，常见的问题是因为上传指定的空间不是华东的存储空间，换成华东的空间一般可以解决。 |
| Q9: 七牛对象存储是否可以搭建网站？ |
|---|
| 对象存储只能用于文件存储，无法用来部署web网站或博客并运行。如果需要部署web网站或博客，建议购买 云主机 或 轻量应用服务器 来部署服务，web网站或博客中的静态资源(比如：图片、js、html、视频等)可以上传至七牛对象存储空间，然后通过外链来调用加载，对象存储使用参考 对象存储快速入门文档 |
| Q10: 对象存储的文件大小是否有限制？ |
|---|
| 存储空间的单个文件大小没有限制。 |
| Q11: 存储空间最大支持预览的视频或图片是多大？ |
|---|
| 视频或图片大小没有限制。 |
| Q12: 上传慢，上传速度怎么进一步提升 |
|---|
| 上传速度主要取决于上传端的网络，客户端上行带宽越高，上传速度越快，理论上1Mbps的上行带宽理论峰值上传速度 = 1 / 8 = 0.125MB/s ，也就是125KB/s 。另外就是可以考虑使用加大并发上传，将有限的带宽更充分利用。 如果加大并发并且网络上行带宽充足的情况下，上传速度始终在200KB/s左右，那么有可能是本地网络的限制，可以考虑使用自定义上传加速域名上传，传输加速。 注意：自定义上传加速域名，需要配置cname解析，且上行流量是需要额外计费的 |
| Q13: 为什么存储空间的资源在七牛控制台无法预览查看？ |
|---|
| 1：是否可以预览查看取决于资源格式在对应浏览器是否支持？浏览器支持的格式可以在控制台预览查看。 |
| 2：存储空间或CDN域名开启了referer防盗链功能，也会影响在线预览功能，开启空间referer防盗链或CDN域名referer防盗链的空间资源需要在七牛控制台预览查看的话，需要将 portal.qiniu.com 域名也加入referer白名单。空间referer防盗链配置文档参考：设置Referer防盗链,CDN域名的referer配置文档参考：Referer防盗链 |
文档反馈
(如有产品使用问题，请 提交工单)