如何为Visual Studio桌面应用创建Crystal或MS Reports安装包并解决运行报错

Crystal Reports 报错 #

Application: Crystals.exe
Framework Version: v4.0.30319
Description: The process was terminated due to an unhandled exception.
Exception Info: System.BadImageFormatException
   at CrystalDecisions.Shared.SharedUtils..cctor()

Exception Info: System.TypeInitializationException
   at CrystalDecisions.Shared.SharedUtils.get_CurrentControl()
   at CrystalDecisions.Shared.SharedUtils.GetEffectiveCulture()
   at CrystalDecisions.Shared.LocaleManager..ctor()
   at CrystalDecisions.Windows.Forms.CrystalReportViewer.InitReportViewer()
   at CrystalDecisions.Windows.Forms.CrystalReportViewer..ctor()
   at Crystals.Form1.InitializeComponent()
   at Crystals.Form1..ctor()

Exception Info: System.InvalidOperationException
   at Crystals.My.MyProject+MyForms.Create__Instance__[[System.__Canon, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]](System.__Canon)
   at Crystals.My.MyProject+MyForms.get_Form1()
   at Crystals.My.MyApplication.OnCreateMainForm()
   at Microsoft.VisualBasic.ApplicationServices

RDLC 报表报错 #

Faulting Application name:ReportViewerSample.exe,version:1.0.0.0, time stamp:0x6130af2a
Faulting module name:KERNELBASE.dll,version:10.0.10240.16384, time stamp:0x559f3b2a
Exception code:0xe0434352
Fault offset:0x000b3e28
Faulting process id:0x17b4
Faulting application start time:0x01d7a059329df75d
Faulting application path: C:\Program Files(x86)\Beymo\RDLCViewer\ReportViewerSample.exe
Faulting module path: C:\Windows\SYSTEM32\KERNELBASE.dll
Report id: 57ed1ef9-6ed3-418f-952a-aea23f09618b
Faulting package full name:
Faulting package-relative application ID:

Log Name:   Application
Source:     Application error
Event ID:   100

两类报错均指向程序集架构不匹配：Crystal Reports抛出的System.BadImageFormatException是典型的32位进程加载64位程序集（或反向）的错误，RDLC的异常同样是运行时依赖和编译目标架构不匹配导致。不带报表功能的项目可正常运行，说明问题完全出在报表相关的依赖加载环节。

1. 固定项目编译目标架构 #

• 打开Visual Studio项目属性，切换至「生成」选项卡
• 禁用「Any CPU」选项，根据客户端系统情况固定目标平台：
  • 客户端以32位系统为主选x86，勾选「首选32位」
  • 客户端以64位系统为主选x64
  • 如需兼容两类系统，分别编译打包两个版本

2. 匹配对应架构的报表运行时 #

Crystal Reports适配 #

• 卸载客户端已安装的所有Crystal Reports运行时
• 安装与项目编译架构、开发引用的SDK版本完全一致的Crystal Reports运行时：x86编译的项目必须装32位运行时，x64编译的项目必须装64位运行时，运行时版本不能高于或低于开发时引用的版本

RDLC适配 #

• 卸载客户端已安装的RDLC运行时
• 安装与项目编译架构、项目引用的Microsoft.ReportViewer包版本完全一致的Microsoft Report Viewer Runtime

3. 校验.NET Framework依赖 #

• 确认客户端安装的.NET Framework版本不低于项目目标框架版本，优先安装完整版.NET Framework，避免使用Client Profile版本

4. 排查打包配置问题 #

• 打包时明确包含报表相关的依赖程序集，不要默认使用系统全局程序集
• 安装路径避免使用中文、特殊字符，安装包申请足够的目录访问权限
• 测试时可先将本地编译好的程序直接拷贝到客户端运行，排除打包环节引入的错误

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