SmobilerService6.x 安装异常排查指南

有时可能会出现安装成功,但使用浏览器访问 http://localhost:15486 无法找到网站的情况。

出现此问题时,请遵照以下步骤进行检查。

一、请首先检查 6.x(不含) 以前的旧版本是否已完全移除:

1. 停止旧版本 Windows 服务 Smobiler Server 。 使用快捷键 Win+R 运行 services.msc 找到 Smobiler Server 服务,右键停止运行:

2. 删除旧版本的全部安装文件。 默认路径是 C:\Program Files(x86)\Smobiler Service :

3. 删除 Windows 服务 Smobiler Server 。 以管理员身份运行 cmd 控制台程序,执行以下命令:

sc.exe delete "SmobilerServer"

如果出现 "Access Denied" 的错误,请以管理员身份运行控制台程序。或者你也可以参阅微软官方文档 如何:安装和卸载 Windows 服务 移除此 Windows 服务。

4. 移除旧版本 IIS 网站。打开 IIS 管理工具,找到 SmobilerService 网站并删除。

请一定确认以上步骤已执行完毕,否则因为旧版本占用 15486 端口,新版本 Service 使用同样的端口,会因端口冲突而无法启动。

二、确认已经安装了环境

必须同时下载并安装以下 总计 2 个 运行环境:

如果你是 64 位 Windows 操作系统请同时下载安装以下 2 个文件:

如果你是 32 位 Windows 操作系统请同时安装以下 2 个文件:

如果你是高级用户,有能力明确操作系统版本与位数,我们推荐你从此页面选择最适合你的运行环境版本。请同时安装 ASP.NET Core Runtime 和 .NET Core Runtime 运行时环境。

三、重新安装 SmobilerService6.x

确保完成 以上步骤后,可重新全新安装 Smobiler Service 6.x 。


如果你仍然遇到问题:

请用文件管理器打开 C:Program Files(x86)\Smobiler Service\server (默认安装目录),然后在地址栏输入 cmd 回车,继续在弹出的命令行窗口中输入 dotnet Smobiler.Service.Web.dll ,携带输出的错误信息截图联系技术支持人员。

请注意,在联系技术支持时,请尽量详细的描述你所遇到的问题与尝试过的解决方案。例如:

  • 是否 Windows 服务删除时遇到难以解决的错误,并提供准确的错误信息。
  • 是否在删除 IIS 网站时遇到无法解决的问题,并提供准确的错误信息。
  • 是否在查找旧版本安装目录时出现无法删除的情况,并提供无法删除的文件的准确信息。

其他

Windows Server 2012R2 罕见错误

以下错误较为罕见,他们出现在 Windows Server 2012R2 的操作系统上,有极小概率发生。

无法启动此应用程序,因为计算机中丢失 api-ms-win-crt-runtime-|1-1-0.dll 。

此错误请从微软下载并安装 C++ 组件: https://www.microsoft.com/zh-cn/download/details.aspx?id=48145

此 C++ 组件在安装过程中如果提示失败,则需要先安装一个 Windows 补丁 KB2999226 https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows 。如果在安装 KB2999226 的过程中再次失败,则请重启操作系统,然后从 Windows 更新中手动移除此补丁再次尝试直至成功即可,这通常是由网络原因所导致的,多次尝试或使用改善网络状况的软件均可解决。

Windows Server 2008R2 罕见错误

以下安装错误也曾得到过一次用户反馈,当使用 dotnet 命令启动 SmobilerService.Web.dll 排查错误时,Windows Server 2008R2 操作系统引发了如下错误:

导致此错误的原因是 dotnet 环境安装失败,dotnet 在启动时由于操作系统低于最低版本要求而缺少前置依赖环境,出现无法加载 dotnet 指定类库的问题。

请访问此微软官方页面: https://docs.microsoft.com/zh-cn/dotnet/core/install/windows?tabs=netcore31#dependencies ,根据操作系统版本进行前置补丁的安装与下载。

仅针对于 Windows Server 2008R2 ,用户反馈遇到此问题时,通过安装 KB2533623 补丁即解决了问题。