Dropstone 故障排除指南 - 诊断与修复问题

本指南提供了系统化的方法来诊断和解决 Dropstone.io 的常见问题。请按照以下步骤收集必要的信息，然后再联系支持团队。

故障排除所需的基本信息

以下信息对于 Dropstone 中的大多数故障排除场景至关重要：

1. 视觉文档

问题截图（请遮盖敏感信息）

• 捕获显示错误的整个应用程序窗口
• 包含所有错误消息或对话框
• 确保时间戳可见（如果可用）

2. 复现步骤

提供详细的问题复现步骤：

1. 执行的操作（例如："点击'部署'按钮"）
2. 预期行为
3. 实际行为
4. 发生频率（总是、有时、一次）

3. 系统信息

从以下位置获取系统信息：

Dropstone → 帮助 → 关于

包括：

• Dropstone 版本
• 操作系统
• 架构（x64、arm64）
• Electron 版本
• Node.js 版本

4. 网络配置

您是否使用了以下任何一项？

• VPN（虚拟专用网络）
• Zscaler 或其他安全代理
• 企业防火墙
• 自定义 DNS 设置

5. 开发者工具控制台

访问开发者工具以检查 JavaScript 错误：

Dropstone → 帮助 → 切换开发者工具

导航到控制台选项卡并检查：

• 红色错误消息
• 与您的问题相关的警告消息
• 网络请求失败

复制任何相关的错误堆栈跟踪。

6. 应用程序日志

Windows

日志位于：

C:\Users\<您的用户名>\AppData\Roaming\Dropstone\logs

通过命令面板访问：

1. 按 Ctrl + Shift + P
2. 输入并选择：开发者：打开日志文件夹

macOS

日志位于：

~/Library/Application Support/Dropstone/logs

通过命令面板访问：

1. 按 Cmd + Shift + P
2. 输入并选择：开发者：打开日志文件夹

Linux

日志位于：

~/.config/Dropstone/logs

在应用程序中查看日志

导航到： Dropstone → 终端 → 输出

从下拉菜单中选择：

• 窗口 - 一般应用程序日志
• Dropstone 核心 - 核心功能日志
• Dropstone 部署 - 与部署相关的日志
• Dropstone 存储 - 存储和数据库日志
• Dropstone API - API 请求/响应日志

常见问题及解决方案

连接问题

问题：无法连接到 Dropstone 服务

症状：

• "连接超时"错误
• "无法访问服务器"消息
• 无限加载状态

解决方案：

1. 检查互联网连接

   # Windows
   ping dropstone.io
   
   # macOS/Linux
   ping dropstone.io
   

2. 验证防火墙设置

   • 确保 Dropstone 已获准通过防火墙
   • 检查企业网络策略
   • 将 *.dropstone.io 域名加入白名单

3. 代理配置

   配置代理设置：

   Dropstone → 设置 → 网络 → 代理设置

   或设置环境变量：

   export HTTP_PROXY=http://proxy.example.com:8080
   export HTTPS_PROXY=http://proxy.example.com:8080
   

4. DNS 解析

   • 刷新 DNS 缓存
   • 尝试备用 DNS（8.8.8.8、1.1.1.1）

身份验证问题

问题：登录失败或令牌过期

症状：

• "身份验证失败"错误
• 重复的登录提示
• 401 未授权响应

解决方案：

1. 清除身份验证缓存

   Dropstone → 命令面板 → 清除身份验证缓存

2. 重新进行身份验证

   1. 从 Dropstone 退出登录
   2. 清除 dropstone.io 的浏览器 Cookie
   3. 重新登录
   

3. 检查令牌有效性

   导航到：设置 → 账户 → 会话管理

   查看活动会话并撤销可疑会话。

4. SSO 问题

   如果使用单点登录：

   • 验证 SSO 提供商是否可访问
   • 检查 SAML 断言是否过期
   • 联系您的身份提供商管理员

性能问题

问题：应用程序响应缓慢或 CPU 使用率高

症状：

• 打字或点击时出现延迟
• CPU/内存使用率高
• UI 冻结或无响应

解决方案：

1. 检查资源使用情况

   Dropstone → 帮助 → 进程管理器

   识别消耗过多资源的进程。

2. 禁用扩展

   临时禁用扩展以隔离问题：

   设置 → 扩展 → 全部禁用 → 重启

3. 清除缓存

   Dropstone → 设置 → 高级 → 清除缓存
   

4. 减小项目规模

   • 从索引中排除大文件
   • 添加到 .dpsignore 文件：
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. 硬件加速

   切换 GPU 加速：

   设置 → 系统 → 使用硬件加速

部署问题

问题：部署失败

症状：

• 构建失败
• 部署超时
• "无法推送到远程"错误

解决方案：

1. 检查构建日志

   查看详细的构建输出：

   部署 → 历史记录 → 选择失败的部署 → 查看日志

2. 验证环境变量

   设置 → 部署 → 环境变量
   

   确保所有必需的变量都已设置。

3. 检查部署配置

   验证您的 dropstone.config.js：

   module.exports = {
     build: {
       command: 'npm run build',
       output: 'dist'
     },
     deployment: {
       region: 'us-east-1',
       runtime: 'nodejs18.x'
     }
   }
   

4. 存储配额

   验证您是否未超出存储限制：

   仪表板 → 使用情况 → 存储

5. 构建超时

   在配置中增加超时时间：

   deployment: {
     timeout: 900 // 15 分钟（以秒为单位）
   }
   

存储和数据库问题

问题：数据同步或存储错误

症状：

• "超出存储配额"
• 同步冲突
• 数据未持久化

解决方案：

1. 检查存储使用情况

   仪表板 → 存储 → 使用统计

2. 解决同步冲突

   1. 导航到冲突文件
   2. Dropstone 将显示冲突标记
   3. 手动解决或选择要保留的版本
   

3. 数据库连接

   测试数据库连接：

   // 在 Dropstone 控制台中
   await dropstone.db.test()
   

4. 清除本地缓存

   设置 → 存储 → 清除本地缓存
   

   警告：这将删除本地缓存的数据。

5. 备份和恢复

   在故障排除前创建备份：

   Dropstone → 工具 → 备份 → 创建备份
   

高级故障排除

安全模式

以安全模式启动 Dropstone 以禁用所有扩展：

Windows/Linux：

dropstone --disable-extensions

macOS：

/Applications/Dropstone.app/Contents/MacOS/Dropstone --disable-extensions

重置为默认设置

要将所有设置重置为默认值：

1. 备份当前设置

   设置 → 高级 → 导出设置
   

2. 重置

   设置 → 高级 → 重置所有设置
   

详细日志记录

启用详细日志以进行调试：

1. 打开命令面板（Ctrl/Cmd + Shift + P）
2. 选择：开发者：设置日志级别
3. 选择：跟踪

日志现在将包含详细的诊断信息。

网络诊断

运行内置网络诊断：

Dropstone → 帮助 → 运行网络诊断

这将检查：

• DNS 解析
• API 端点可访问性
• WebSocket 连接
• CDN 可用性

获取帮助

联系支持之前

确保您已：

• 查看本故障排除指南
• 查看状态页面
• 收集所有必要的故障排除信息

联系支持

电子邮件： support@blankline.org

在您的消息中包含：

1. 问题摘要
2. 复现步骤
3. 系统信息
4. 相关日志（最后 100 行）
5. 截图
6. 您已尝试过的操作

其他资源

• 文档： docs.dropstone.io
• 状态页面： status.dropstone.io
• 销售/企业： dropstone.io/contact

常用命令

命令面板快速参考

CLI 诊断

# 检查 Dropstone CLI 版本
dropstone --version

# 验证安装
dropstone doctor

# 测试 API 连接
dropstone ping

# 查看当前配置
dropstone config list

# 清除本地缓存
dropstone cache clear

# 导出日志
dropstone logs export --output ./dropstone-logs.txt

附录

日志文件位置

配置文件位置

环境变量

最后更新：2025 年 9 月 29 日 版本：1.0.0