档案管理软件安装失败全场景排查与可落地实操解决方案

前置准备：安装前必做校验

1. 环境兼容性校验

首先确认系统版本符合要求：Windows端要求Win10 1909及以上/Win11 21H2及以上，Linux服务器端要求CentOS7.6+/Ubuntu20.04+，国产统信/银河麒麟系统要求V10 2022及以上版本。

提前安装必备运行库：

• VC++2015-2022可再发行包（64位）：https://aka.ms/vs/17/release/vc_redist.x64.exe，32位系统下载：https://aka.ms/vs/17/release/vc_redist.x86.exe
• .NET6.0桌面运行时：https://dotnet.microsoft.com/zh-cn/download/dotnet/thank-you/runtime-desktop-6.0.25-windows-x64-installer

2. 安装包完整性校验

请从官方渠道下载安装包，国内主流档案软件官方下载地址：

• 南天档案系统：https://www.nantian.com.cn/product/112.html
• 博阳档案管理系统：https://www.boyangsoft.com/product/archives

下载完成后校验安装包完整性：

• Windows系统打开CMD，执行命令：certutil -hashfile 你的安装包完整路径 MD5
• Linux系统执行命令：md5sum 你的安装包完整路径

常见安装失败场景实操解决方案

场景1：双击安装包无响应/提示权限不足

第一步：右键点击安装包，选择「以管理员身份运行」，90%的权限类问题可通过该步骤解决。

如果仍无响应，执行第二步：关闭系统安全防护，Win11路径：设置-隐私和安全性-Windows安全中心-病毒和威胁防护-管理设置，关闭实时保护、云提供的保护、自动样本提交；Win10路径类似。

第三步：完全退出所有杀毒软件（360/腾讯电脑管家/火绒等），右键点击杀毒软件托盘图标，选择「完全退出」，部分杀毒需要输入验证码确认，完全关闭后再重试安装。

场景2：安装过程中提示「文件写入失败/磁盘空间不足」

第一步：检查安装盘剩余空间，档案软件至少预留20G可用空间，如果不足，右键目标安装盘选择「属性-磁盘清理」，勾选临时文件、下载文件、回收站，点击确定清理，或更换剩余空间足够的盘符安装。

第二步：修改安装目录权限，比如要安装到D:\Program Files\档案软件，右键该父文件夹，选择「属性-安全-编辑」，选中当前登录的用户，勾选「完全控制」权限，点击确定保存。

第三步：如果提示「文件被占用」，按Ctrl+Shift+Esc打开任务管理器，在「详细信息」 tab 找到同名的档案软件旧进程，右键选择「结束任务」，再重试安装。

场景3：安装完成后启动提示「缺少组件/运行异常终止」

第一步：安装数据库依赖组件，大部分档案软件依赖SQL Server LocalDB 2019，官方下载地址：https://download.microsoft.com/download/7/c/1/7c14e92e-bdcb-4f89-b7cf-93543e7112d1/SqlLocalDB.msi，管理员身份打开CMD执行以下命令静默安装： ``` msiexec /i SqlLocalDB.msi IACCEPTSQLLOCALDBLICENSETERMS=YES ```

第二步：重置软件配置文件，打开资源管理器，地址栏输入%appdata%\，找到对应档案软件的文件夹（比如「NantianArch」/「BoyangArch」），直接删除整个文件夹，再重新启动软件。

如果是Linux服务器端安装报错，先关闭SELinux，执行命令： ``` setenforce 0 && sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config ``` 然后开放软件所需端口（默认8080）： ``` firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload ``` 再重新启动服务即可。

场景4：升级安装时提示「旧版本卸载失败/残留文件冲突」

第一步：完全卸载旧版本，Windows打开「设置-应用-安装的应用」，找到对应的档案软件，点击卸载按提示完成操作；Linux端执行sudo dpkg -r 软件包名卸载。

第二步：清理残留注册表，按Win+R输入regedit打开注册表编辑器，依次展开路径：HKEY_CURRENT_USER\Software、HKEY_LOCAL_MACHINE\SOFTWARE，找到对应档案软件的注册表项，右键删除，注意删除前先右键选择「导出」备份注册表，避免误删。

第三步：清理残留安装文件，资源管理器地址栏输入%programfiles%，找到对应档案软件的安装文件夹，直接删除，然后重启电脑，再安装新版本。

安装成功后校验步骤

1. 安装完成后右键点击桌面软件图标，选择「属性-打开文件所在位置」，检查目录下所有文件是否完整，没有缺失的dll文件。

2. 双击启动软件，登录默认管理员账号（账号admin，默认密码123456，部分软件默认密码为admin），进入软件后尝试新建一个档案条目，上传一个10M以内的测试文件，确认上传、查询、导出功能都正常。

3. 按Win+R输入services.msc打开服务列表，检查「档案软件数据服务」「档案软件定时任务服务」状态都是「正在运行」，启动类型设置为「自动」，避免重启电脑后服务不启动。

避坑注意事项

1. 不要把档案软件安装在中文目录、带空格的目录或者桌面路径下，推荐安装路径为D:\soft\arch\xxx，全英文无特殊字符。

2. 国产操作系统（银河麒麟/统信UOS）安装时，必须下载对应CPU架构的安装包（x86/arm64），不要混用，安装命令为sudo dpkg -i 安装包名.deb，如果提示依赖缺失，执行sudo apt install -f -y修复依赖后再重新安装。

3. 安装过程中不要强制中断安装、不要关机，如果出现卡死的情况，打开任务管理器结束安装进程后，按照场景4的步骤清理残留再重新安装。