thinkphp七牛云上传失败主因是环境、配置或网络问题：需确认使用store()而非moveto()、disk配置正确、token有效且未过期、服务器能连通upload.qiniup.com、禁用异常callback回调。
ThinkPHP 七牛云上传失败，多数情况不是框架写错了，而是环境、配置或网络链路出了问题。重点不在代码逻辑，而在上传路径是否走通、凭证是否有效、网络能否抵达七牛服务端。
检查上传驱动是否匹配七牛配置
ThinkPHP 6+ 的 $file->moveTo() 只适用于 local 驱动，调用七牛必须改用 $file->store() 或 $file->storeAs()。如果代码里还在用 moveTo，会直接报错或静默失败。
- 确认 config/filesystem.php 中七牛 disk（如
'qiniu'）已正确定义，且'type' => 'qiniu' - 确保
store()调用时指定了该 disk：$file->store('images', 'qiniu')，不能省略第二个参数 - 打印返回值：
var_dump($file->store('test', 'qiniu'))，正常应返回类似test/xxx.jpg的路径；若返回false或抛出异常，说明 disk 初始化失败或凭证无效
验证七牛 Token 是否有效且未过期
上传失败报 bad token 或 401 Unauthorized，基本锁定为上传凭证问题。Token 是有时效的，通常默认 3600 秒（1小时），后端生成后未及时刷新就会失效。
- 检查生成 token 的代码：是否用了正确的
ACCESS_KEY、SECRET_KEY和bucket - 确认 token 生成时未误传空字符串或硬编码过期 token
- 可在控制器中临时加一行日志：
Log::info('upToken: ' . $token);，复制到七牛官方工具（如 qshell）里验证是否可上传
排查服务器到七牛的网络连通性
本地能传、线上 502 Bad Gateway 或超时，大概率是服务器出口网络受限，而非 PHP 代码问题。
- 在服务器执行：
curl -v https://upload.qiniup.com，看是否能建立连接、返回 200 或 400（400 表示通路正常，只是参数错） - 若卡住或报
Connection timed out，说明 DNS 解析失败或防火墙拦截。尝试换 DNS：echo "nameserver 223.5.5.5" > /etc/resolv.conf - 部分云厂商（如阿里云、腾讯云）安全组默认禁止外发 80/443 以外端口，需确认
upload.qiniup.com:443出方向放行
避免回调配置引发的上传中断
如果启用了七牛 callback（如上传后通知业务服务器），而 callbackUrl 不可达（如内网地址、HTTPS 证书不被信任、域名未备案），七牛会拒绝上传并返回 502 或 500。
- 临时注释掉 callback 相关配置（
callbackUrl、callbackBody），测试是否恢复上传 - 若去掉 callback 就成功，说明问题出在回调服务本身：检查 callbackUrl 是否公网可访问、是否支持 HTTPS、响应是否在 5 秒内完成
- 生产环境建议用七牛的持久化处理（pipeline）替代实时回调，更稳定
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
