保存后别忘了测试上传：Clara 云存储测试按钮的验证逻辑

照着这篇做一遍，你就能搞明白 Clara 后台那个「云存储测试」按钮到底在验什么、什么情况下会报错，以及为什么保存成功不代表上传能用。

第一步：先找到入口，别在错的地方找

云存储的配置和测试都在后台的「系统设置 → 云存储」这一栏里，和「上传限制」是分开的两个位置。

流程是：按你的服务商要求把云存储参数填进去 → 点保存 → 再点测试（按钮就在同一页）。

很多人第一次配完，填完参数直接关页面走了，以为"保存了就是配好了"。这是最常见的坑：保存只说明参数存进了数据库，不代表这套参数真的能用。

注意：保存后系统不会自动替你跑一遍远端请求。所以配置项填错一个字、密钥少复制一位，保存时都不会报错，只有你主动点测试才会暴露。

第二步：测试按钮验的是哪几件事

测试按钮的作用，简单说就是拿你当前已保存的参数，真实跑一次上传链路，而不是只看格式对不对。它依次要过这三关：

1. 参数齐不齐——必填项缺失、明显格式不对的，第一关就过不去，直接提示。
2. 远端连不连得上、写不写得进去——这一步是真实发请求。密钥错、权限不足、存储路径不存在，都会在这一步失败。
3. 链路通不通——上传进去之后能不能正常访问，拿到一个可用的结果。这一步失败通常说明配置本身能写、但对外呈现有问题。

所以它验的不是"你填得漂不漂亮"，而是"这条链路走不走得通"。

注意：第 2、3 关都是网络请求，慢一点、偶尔超时是正常的，先重试一次再判断。但如果每次都失败，那就是配置本身的问题，别反复点。

第三步：测试失败了怎么排

先看测试返回的提示文字，再对照查：

• 提示参数类错误：回去核对密钥、存储桶、域名这些字段，重点检查复制时有没有多空格、少了字符。改完记得先保存，再点测试——不保存直接测试，测的还是旧参数，你会越测越懵。
• 提示连接/超时：确认服务器能正常访问外网（有些机器出口被限制），确认服务商那边的存储桶确实建好了。
• 提示写入失败：多半是权限或存储策略问题，去服务商后台检查密钥的授权范围。

顺便提醒一个容易混淆的点：后台「系统设置 → 上传」里的"允许的扩展名"（管图片）和"附件允许的扩展名"（管附件）是两个独立字段。云存储配好了，但如果这里的白名单没包含你要传的格式，上传照样会失败，而且报的错完全不一样。

注意：如果测试按钮本身能通过，但实际发帖传图还是失败，问题基本已经不在云存储了，去查 PHP 的 `upload_max_filesize` 和 `post_max_size`——宝塔默认只有 2M，手机照片经常超，建议调到 30M 以上。

第四步：测试通过 ≠ 收工，做一次真实业务验证

按钮通过只代表链路通。稳妥的做法是再走一遍真实场景：

1. 前台发一个测试帖，传一张图片、再加一个附件；
2. 换一个没登录的浏览器（或手机流量）打开帖子，看图片能不能正常显示、附件能不能下载。

这一步是为了确认：文件确实落在你配的存储上，而且游客和普通用户也能访问——有些存储默认私有，测试能过，前台却全是裂图。

验证完把测试帖删掉就行，前台删除是软删除，会进回收站保留 30 天，随时能恢复。

注意：Clara 是保存即生效的，改完配置、改完上传限制都不需要清缓存，别浪费时间去找缓存按钮。

小结

• 云存储在后台「系统设置 → 云存储」，测试按钮验证的是参数完整性 + 真实上传链路是否走得通，不是格式检查。
• 铁律：先保存，再测试。不保存就测，测的是旧参数。
• 测试返回的提示文字就是排查方向，别跳过它去瞎改。
• 测试通过后还要发一帖真实上传，并用未登录状态确认图片和附件能正常访问。
• 云存储通过但上传仍失败，优先查上传白名单（图片/附件是两个独立字段）、PHP 上传上限、uploads 目录可写三项。
• 全程无需清缓存，保存即生效。