guoyu/log/云端打包缓存清除完整步骤.md

云端打包缓存清除完整步骤

❌ 问题现状

云端打包仍然报错：Cannot find a parameter with this name: errorMsg

原因： 云端使用了缓存的旧代码（version 1.0.9），没有使用最新的代码（version 1.0.12）

---

✅ 已完成的修改

1. ✅ 插件版本升级

   • 从 1.0.9 → 1.0.12
   • 文件：uni_modules/xwq-speech-to-text/package.json

2. ✅ 代码已修复

   • 所有 error 已改为 errorMsg
   • 文件：uni_modules/xwq-speech-to-text/utssdk/app-android/index.uts

3. ✅ 添加版本标记

   • 在代码开头添加了 VERSION: 1.0.12 注释

---

🚀 彻底清除云端缓存的方法

方法1：使用自定义基座（推荐） ⭐⭐⭐⭐⭐

自定义基座不使用云端编译，直接在本地编译插件。

步骤：

1. 在 HBuilderX 中：

   运行 → 运行到手机或模拟器 → 制作自定义调试基座
   

2. 选择证书：

   • 使用云端证书或
   • 使用自有证书

3. 等待编译完成（约 5-10 分钟）

4. 安装自定义基座到手机

5. 使用自定义基座运行

   运行 → 运行到手机或模拟器 → 运行到自定义基座
   

优点：

• ✅ 完全避免云端缓存问题
• ✅ 编译速度更可控
• ✅ 可以重复使用

---

方法2：修改插件 ID（强制清除缓存） ⭐⭐⭐⭐

修改插件 ID，云端会认为这是全新的插件。

步骤：

1. 修改 package.json

   {
     "id": "xwq-speech-to-text-fixed",  // 改名！
     "version": "1.0.12"
   }
   

2. 保存所有文件

   Ctrl + Shift + S
   

3. 重新云端打包

注意： 打包成功后，记得改回原来的 ID！

---

方法3：联系 DCloud 清理服务器缓存 ⭐⭐⭐

如果以上方法都不行，联系官方：

1. 访问 DCloud 论坛

   https://ask.dcloud.net.cn/
   

2. 发帖说明情况

   标题：云端打包缓存未更新，请求清理
   内容：
   - 项目 ID: __UNI__08E0C13
   - 插件: xwq-speech-to-text
   - 版本: 1.0.12
   - 问题: 云端仍使用旧代码编译
   

3. 等待官方处理（通常 1-2 工作日）

---

方法4：等待云端缓存过期 ⭐⭐

DCloud 云端缓存通常会在 24-48 小时后自动过期。

操作：

• 明天或后天再尝试打包
• 不修改任何代码
• 直接打包

---

方法5：删除并重新导入插件 ⭐⭐

完全删除插件，然后重新导入。

步骤：

1. 备份插件目录

   复制整个 uni_modules/xwq-speech-to-text 文件夹到桌面
   

2. 在 HBuilderX 中删除插件

   右键 uni_modules/xwq-speech-to-text → 删除
   

3. 重启 HBuilderX

4. 重新导入插件

   将备份的 xwq-speech-to-text 文件夹
   复制回 uni_modules/ 目录
   

5. 重新打包

---

📋 推荐执行顺序

立即可以尝试：方法2（修改插件ID）

1. 修改 package.json 中的 id

   "id": "xwq-speech-to-text-v2"
   

2. 保存所有文件

3. 云端打包

4. 如果成功，改回原 ID：

   "id": "xwq-speech-to-text"
   

---

如果方法2不行：使用方法1（自定义基座）

这是最可靠的方法，完全避免云端缓存问题。

---

🎯 验证是否使用新代码

检查打包日志

打包时查看日志，应该显示：

✅ 正确：
[HBuilder] 编译插件 xwq-speech-to-text (1.0.12)
[HBuilder] BUILD SUCCESSFUL

❌ 错误（仍使用旧代码）：
[HBuilder] 编译插件 xwq-speech-to-text (1.0.9)
[HBuilder] Cannot find a parameter with this name: errorMsg

---

⚠️ 注意事项

1. 保存所有文件

修改后必须保存：

Ctrl + Shift + S  (保存所有)

2. 不要同时打包多个版本

如果有打包任务在队列中，等待完成或取消后再打包。

3. 检查网络

确保 HBuilderX 可以正常连接云端服务器。

4. 避免频繁打包

如果短时间内多次打包失败，可能被限流，等待 10-15 分钟再试。

---

🔧 临时解决方案：本地打包（如果有 Android Studio）

如果您有 Android Studio 和 Android SDK：

步骤：

1. 导出 Android 项目

   HBuilderX → 发行 → 原生 App-本地打包 → 生成本地打包App资源
   

2. 用 Android Studio 打开项目

   打开 unpackage/resources/__UNI__08E0C13/android/
   

3. 编译 APK

   Build → Build Bundle(s) / APK(s) → Build APK(s)
   

优点：

• ✅ 完全本地编译，无缓存问题
• ✅ 可以实时查看编译过程

缺点：

• ❌ 需要安装 Android Studio
• ❌ 需要配置 Android SDK
• ❌ 首次配置较复杂

---

📊 各方法对比

方法	成功率	时间	难度	推荐度
自定义基座	⭐⭐⭐⭐⭐	10分钟	简单	⭐⭐⭐⭐⭐
修改插件ID	⭐⭐⭐⭐	5分钟	简单	⭐⭐⭐⭐
联系官方	⭐⭐⭐⭐⭐	1-2天	简单	⭐⭐⭐
等待过期	⭐⭐⭐	1-2天	简单	⭐⭐
删除重导	⭐⭐⭐	10分钟	简单	⭐⭐⭐
本地打包	⭐⭐⭐⭐⭐	30分钟	复杂	⭐⭐

---

✅ 总结

立即尝试

1. 方法2：修改插件 ID → 快速测试
2. 方法1：自定义基座 → 最可靠

如果以上都不行

3. 方法3：联系官方 → 等待官方处理

---

📞 获取帮助

DCloud 官方支持

• 论坛： https://ask.dcloud.net.cn/
• 文档： https://uniapp.dcloud.net.cn/
• QQ群： 见官网

搜索类似问题

在 DCloud 论坛搜索：

"云端打包缓存"
"Cannot find a parameter"
"插件打包失败"

---

🎯 下一步操作

1. 保存所有修改（已完成 ✅）
2. 选择一个方法执行
3. 打包并查看日志
4. 如果成功，测试语音功能
5. 如果失败，尝试下一个方法

---

现在建议您先尝试方法2（修改插件ID），如果不行再使用方法1（自定义基座）！ 🚀