如何制作带数据库的C#桌面应用安装包及解决客户端运行报错

报错截图参考：

按优先级从高到低排查：

• 先排除安装包漏文件问题
  直接把你本地编译生成的整个Release文件夹（所有DLL、配置文件、数据库文件全带上）拷贝到客户机，双击exe运行：
  • 如果能正常跑：说明安装包制作漏了依赖文件，回头检查打包规则，把所有输出目录下的文件都设为打包内容，不要只手动选主程序就完事
  • 如果还是报同样的错：往下排查
• 数据库依赖缺失排查
  • 如果你用的是SQL Server LocalDB：开发机因为装了Visual Studio默认自带LocalDB运行时，绝大多数客户机不会预装这个组件，必须把对应版本的LocalDB安装包打进你的安装包，作为前置依赖在安装时自动部署。
  • 如果你用的是SQLite/SQL CE这类嵌入式数据库：检查项目引用里的数据库驱动DLL有没有设置「复制本地=是」，有没有把x86、x64两个文件夹下的互操作DLL（比如SQLite.Interop.dll）一起打包，缺对应架构的文件在不同位数系统上会直接启动失败。
  • 如果你用的是独立部署的SQL Server/MySQL：确认客户机能不能正常访问数据库实例，防火墙有没有放行端口，客户机所在网络有没有数据库访问权限。
• 连接字符串配置错误排查
  • 绝对不要硬编码开发机的数据库路径、实例名：比如你本地写的Data Source=DESKTOP-123ABC\SQLEXPRESS这类带自己电脑主机名的实例名，客户机上根本不存在这个实例，必然连接失败。
  • 文件型数据库不要写硬编码绝对路径，用|DataDirectory|宏指代程序数据目录，参考配置：

    <connectionStrings>
      <add name="DbConn" connectionString="Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=|DataDirectory|\data.mdf;Integrated Security=True" providerName="System.Data.SqlClient"/>
    </connectionStrings>
    

  • 不要把可读写的数据库文件放到C:\Program Files或者C:\Program Files (x86)目录下，这两个目录普通用户默认没有写入权限，程序读写数据库时会直接抛权限错误，安装包要把数据库文件部署到%ProgramData%或者对应用户的文档目录下。
• 运行时依赖排查
  确认你开发用的.NET版本（.NET Framework 4.x/.NET Core 3.1/.NET 6/8），客户机有没有安装对应版本的运行时，打包时要把对应运行时设置为安装前置条件，或者选独立部署模式把运行时一起打包进安装包。

内容的提问来源于stack exchange，提问作者hammad raza