如何将包含数据库的ASP .NET Core项目发布为单个可执行文件

默认情况下.NET的单文件发布仅打包程序集和运行时依赖，不会自动包含非程序集类型的静态资源（比如你的数据库文件），可以通过以下两种方案解决：

方案1：将数据库作为嵌入式资源打包并在运行时释放 #

• 右键项目中的数据库文件，选择「属性」，将「生成操作」设置为嵌入式资源，「复制到输出目录」设置为如果较新则复制
• 在程序启动入口添加判断逻辑：检查目标运行路径下是否存在数据库文件，若不存在则从程序嵌入式资源流中将文件写入到目标路径
• 保持原有发布配置重新发布即可，数据库会被直接嵌入到.exe内部

注意：如果程序需要对数据库执行写入操作，建议将数据库释放到Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)下的程序专属目录，避免写入系统级目录触发权限不足报错。

方案2：修改项目配置直接将静态文件纳入单文件 #

如果不需要额外的释放逻辑，可以直接修改项目配置强制把数据库文件打包到单文件中：

• 右键项目选择「卸载项目」，再点击「编辑项目文件」，在<Project>根节点下添加如下配置：

<ItemGroup>
  <Content Include="你的数据库文件名（比如inventory.db）">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <ExcludeFromSingleFile>false</ExcludeFromSingleFile>
    <PackageCopyToOutput>true</PackageCopyToOutput>
  </Content>
</ItemGroup>

• 保存修改后重新加载项目，执行发布流程即可，数据库会被打包到单文件内，运行时自动解压到临时目录供程序调用

注意：该配置在.NET 6及以上版本原生支持，.NET 5及更低版本需要额外确认单文件打包对静态资源的兼容性。

常见问题规避 #

• 若开启Trim unused assemblies后出现数据库相关依赖找不到的报错，可以在项目文件中添加裁剪排除规则，避免数据库驱动被误裁剪：

<ItemGroup>
  <TrimmerRootAssembly Include="你使用的数据库驱动包名，比如Microsoft.Data.Sqlite" />
</ItemGroup>

• 若数据库带有加密配置，建议对程序集做混淆处理，避免硬编码的密钥被反编译泄露。

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