简介EurekaLog Enterprise 7.7.8.64(源码版)是面向 Delphi 与 CBuilder 开发者的程序漏洞分析检测工具核心价值在于捕获任意异常和内存泄露并在最终用户设备上生成包含文件、类、方法、行号的调用堆栈日志支持通过 Email 或 WEB 回传副本适合中高级桌面应用开发、发布后现场问题定位与企业级项目维护场景。资源以 rar 压缩包发布共 1494 个文件压缩包约 124.36MB文件类型覆盖 hpp/pas/dcu 等源码与编译单元dproj/dpk/dpr 等工程与包描述文件exe/dll 可执行程序与动态库obj/lib/a 等中间库文件chm/pdf 帮助文档以及 dfm 窗体、res/rc 资源文件、bpl 运行时包、ico 图标、bat 构建脚本等目录组织完整便于查阅和二次开发。此企业版附带完整源代码支持包括 10.2、10.3.2 在内的多个 Delphi 版本编译后程序体积仅增加约 300KB对运行时开销影响极小。目前已有 495 人学习下载借助源码可深入定制异常处理逻辑或将其集成到现有构建流程中显著提升软件质量与排错效率。1. EurekaLog 源码版程序漏洞分析检测不是抓 bug而是抓崩溃现场线上程序崩了最怕的往往不是崩溃本身而是用户回一句“刚才用着用着就没了”。EurekaLog 源码版就是专门解决这个场景的程序漏洞分析检测工具它平时几乎不占资源但在未处理异常触发的那一瞬间会把寄存器现场、调用栈、模块版本、系统信息全部写进日志让“本地复现不了”的崩溃变成“看日志十分钟能定位”的崩溃。7.7.8.64 这套源码版尤其适合有一线开发经验的团队因为你可以自己编译、自己定制上报逻辑而不是被安装版的黑匣子牵着走。这篇文章不打算吹它多神只讲怎么把源码版接进你的 Delphi 或 CBuilder 工程哪些配置决定你能拿到一份完整证据链哪些配置会让你只拿到一堆十六进制偏移。后面每一章都会落到可复现的命令和参数上包括我踩过的坑。2. 先弄明白 EurekaLog 在崩溃那一刻做了什么从 SEH 到源码版编译2.1 Windows 异常分发链路里的最后一个“接管点”要理解 EurekaLog 为什么能定位问题先要看懂 Windows 的异常分发。Delphi 的 try/except 捕获的是“在自己的调用层级里抛出的异常”这条链路通常在 VCL 的 Application.Run 消息循环内部。真正麻烦的是三种情况异常发生在工作线程、异常发生在第三方回调里、异常被某个深层 try/except 吞掉后状态已经错乱。这个时候程序可能不会立刻崩但内存已经被破坏后续任何操作都可能触发莫名其妙的异常。Windows 为每个线程都维护一套 SEH 结构化异常处理链如果当前线程的异常没有被任何 handler 处理系统最终会调用 SetUnhandledExceptionFilter 注册的过滤函数。EurekaLog 做事的本质就是在这个系统级的“最后接管点”上挂自己的处理函数。它不只拿到异常对象还能在栈还没被 unwind 之前读取寄存器上下文、模块加载列表、当前线程的调用栈这些信息加在一起才叫“崩溃现场”。所以它的定位和你写一百个 try/except 不一样。try/except 是你在“预期会有错”的地方加保险EurekaLog 是给“你根本没想到会错”的地方兜底。这也是为什么工具名称里强调“漏洞分析检测数据”它检测的不是代码里的逻辑 BUG而是异常发生的上下文。没有上下文光知道“这里除零了”没有任何意义因为除零前的数据来源才是真正的线索。2.2 为什么“源码版”值得放进版本库而不是用安装版EurekaLog 有安装版和源码版两种形态落地适配方案差别非常大。安装版是往开发机器上装一个 IDE 扩展图形界面点一点就能用适合个人快速试水。源码版则是把整套源码包拿回来自己编译成运行期包和设计期包再安装进 IDE。我一般会建议团队用源码版理由有三个。第一版本可控。三个开发成员如果各自装了不同小版本的安装版生成日志的调用栈格式可能不一样后续做日志聚合时字段对不上非常尴尬。源码版放进版本库所有成员用同一个源码包编译产出一致。第二可定制。安装版封装好的上报功能未必符合你的内网协议源码版可以直接改发送函数接你自己的崩溃收集服务。第三构建脚本可以无人值守编译不用每台机器手动点安装向导。下面是我在 Windows 上用命令行编译源码包的习惯写法注意文件名以你下载包里实际的核心包为准#!/usr/bin/env bash set -e # 改成你机器上的 RAD Studio 安装路径 DELPHI_BIN/c/Program Files (x86)/Embarcadero/Studio/21.0/bin # 改成你解压后的源码目录 EU_CORE_DIR/d/dev/third-party/eurekalog-src # 编译产物输出目录 OUT_DIR/d/build/bpl if [ ! -f $DELPHI_BIN/dcc32.exe ]; then echo 找不到 dcc32.exe请检查 DELPHI_BIN 路径 exit 1 fi cd $EU_CORE_DIR # 核心包文件名请替换成源码包里的实际 .dpk $DELPHI_BIN/dcc32.exe -B EurekaLogCore.dpk \ -D WIN32 -D RELEASE \ -U$EU_CORE_DIR \ -E$OUT_DIR \ -R$OUT_DIR这段脚本的核心逻辑是先把运行期包编译出来而不是直接安装。参数方面-B 表示全量重新编译避免旧产物干扰-D WIN32 -D RELEASE 是给包源码条件编译用的宏定义保证产物是发布版本-U 指定单元搜索路径让编译器能找到源码里的其它单元-E 指定 .bpl 输出目录-R 指定资源文件路径。编译完的 .bpl 文件会在后面安装设计期包时被引用。2.3 编译源码包之前先分辨三个模块第一次接触源码版的人最容易在“打开哪个工程文件”上翻车。一个完整源码包通常会分成三块一是核心运行期库它负责异常捕获、日志写入、上报动作程序发布时也要带着对应的运行时能力二是 IDE 设计期包它只在开发环境里存在负责给 Delphi 界面加 EurekaLog 菜单和项目属性页三是配置文件模板或工具程序用来生成默认的异常选项文件。我见过有人直接把设计期包装上但核心运行期库没编译结果 IDE 菜单有一编译项目就报缺少单元也有人只编译了核心库没装设计期包结果项目里无法打开配置页。正确顺序是先编译核心运行期库再安装设计期包。设计期包的编译方式跟核心包一样用 dcc32 编译对应的 .dpk只不过输出目录可以单独放方便 IDE 识别。安装时在 Delphi 的“Component”菜单里找到包安装入口把编译好的设计期 .bpl 添加进去IDE 会自动注册菜单项。注册完成后建议马上重启一次 IDE确认菜单加载没有报错再开始接项目。3. 把 EurekaLog 接入 Delphi 工程最小可用配置与第一次验证3.1 集成向导在 .dpr 里做了什么把 EurekaLog 接进项目常见做法是用 IDE 的集成向导而不是自己手写 uses 和初始化代码。向导会在你的项目工程文件 .dpr 里加入几个引用单元并在 begin...end. 块里插入两步初始化一步注册异常钩子一步设置日志参数。这段工程文件改动是“黑匣子”但你必须知道它长什么样才能在出问题时排查。一个被集成器修改后的 .dpr 示意如下program ClientApp; uses Vcl.Forms, umain in umain.pas {FormMain}, EurekaLogDtl; // 实际单元名以你源码包命名为准 {$R *.res} begin InitializeEurekaLog; // 钩子注册通常由集成器插入 Application.Initialize; Application.MainFormOnTaskBar : True; Application.CreateForm(TFormMain, FormMain); Application.Run; FinalizeEurekaLog; // 反注册避免程序退出时二次崩溃 end.注意一点上面这段里的单元名和过程名只是示意不同版本源码包的命名可能不同。你要关注的是它在工程文件里的位置——初始化代码必须在 Application.Initialize 之前执行。如果放在后面钩子就漏掉了 VCL 启动阶段发生的早期异常。反注册代码放在 Application.Run 之后能让崩溃发生在退出阶段时也能被接住。如果你发现集成向导没有正确插入这两处别急着手动补先确认设计期包安装是否成功否则你补了源码包里的逻辑IDE 菜单还是不会显示配置页。3.2 验证钩子一段不可能正常执行到结束的代码接入后的第一件事不是写业务而是制造一个未处理异常验证钩子。写一个按钮点击后抛出一个异常正常情况下程序会弹系统错误框如果 EurekaLog 钩子生效你会看到它的异常对话框以及日志文件落在配置好的目录里。procedure TFormMain.ButtonForceCrashClick(Sender: TObject); var A: Integer; B: Integer; R: Double; begin A : 1; B : 0; // 故意触发除零异常用于验证异常捕获钩子是否生效 R : A / B; // 如果走到了这里说明异常没有抛出来就要检查编译选项了 ShowMessage(未触发异常请检查优化选项); end;这段代码成功被捕获的前提是Delphi 编译选项里的 Optimization 没有把除零优化掉并且 EurekaLog 钩子确实注册了。如果你跑起来后发现弹的是系统对话框而不是 EurekaLog 的日志对话框第一步先回工程文件里看初始化代码是否被删过第二步看 EurekaLog 配置里是否关闭了“未处理异常显示”。不要一上来就怀疑工具不好用九成情况是工程文件没改完整。3.3 参数怎么定对话框、日志路径、静默模式钩子验证通过后就要按发布环境配置参数了。开发期和发布期的配置应该完全分开这也是很多人容易忽略的地方。开发期建议打开异常对话框以最简单的方式把日志存成本地文件方便调试发布期建议关闭异常对话框改成静默写入日志后自动上报避免终端用户看到陌生的技术弹窗。下面这张表是我常用的参数基线不同项目可以微调。参数项开发期建议值发布期建议值说明异常对话框开启关闭发布期开启会让用户困惑也容易截图后被当作系统 bug日志存储目录项目目录下临时 log 目录%LocalAppData% 下按程序名建目录避免写安装目录导致权限问题日志文件数量不限制按天数轮转留最近 30 天防止日志无限增长塞满磁盘上报方式不启用HTTP 推送到内网收集服务上报逻辑格外依赖源码版的定制能力内嵌调用栈开启开启没有调用栈的日志几乎等于废纸这里最值得强调的是日志目录。许多桌面软件跑在装有防护软件的环境里安装目录是受保护目录写文件会被重定向或者直接拦截。把日志写到 %LocalAppData% 下的独立子目录虽然不是绝对安全但权限问题会少很多。如果程序跑在服务环境还要额外给运行账号配置目录写权限。4. 从日志到代码行MAP 文件、调用栈与版本归档4.1 无符号调用栈为什么不能直接定位EurekaLog 日志里的调用栈最初是一串“模块名 十六进制地址”比如 ClientApp.exe 0x0041A2B4。这种形式只有两个信息崩在哪个可执行文件里以及崩在可执行文件哪个偏移位置。没有符号信息的话你这串地址对不上任何函数名等于拿到了一个保险箱但没钥匙。符号信息的来源是编译器的 MAP 文件。Delphi 在链接的时候可以根据编译单元的代码段偏移生成地址到函数名的映射表。有了 MAP 文件EurekaLog 才能在日志里直接写出“TFormMain.DoRefresh 0x04”这样的调用栈。所以配置 EurekaLog 本身只解决“东西崩了现场被抓住了”能不能快速看出现场是撞在哪个函数上取决于你编译项目时有没有留下符号表。很多团队发布程序时习惯把 “Detailed MAP file” 选项关掉理由是“减小体积”。实际上 MAP 文件不需要打进安装包它只在分析日志时被开发者使用应该作为构建产物归档到服务器上而不是跟着安装包分发。关掉这个选项省下的那点编译时间会在灾难发生后百倍赔回去。4.2 三个必开编译选项让调用栈“点名道姓”在 Delphi 工程选项里和 EurekaLog 配合最低要求开三个开关。第一Linker 页面的 Map File 要选 Detailed这样才能得到包含函数名和入口偏移的完整映射表。第二Compiler 页面的 Debug Information 要打开它会让编译器生成调试符号。第三在 Running Environment 或对应页面里开启堆栈帧指针生成这对调用栈的还原准确度影响很大尤其是在优化开启的发布构建里。这三个开关开完之后编译产物目录里会多出一个 .map 文件。EurekaLog 在写日志时可以读取这个 MAP 文件把地址翻译成函数名如果你用的是集成向导通常它会自动寻找 map 文件。为了保险我习惯把 map 文件拷贝到和 exe 同一个目录再手动运行一次崩溃验证。确认日志里显示的不再是裸地址而是函数名加偏移。这一步通过后才真正具备线上排查条件。4.3 一次“查不到原因”的线上崩溃排查用一个简化的日志片段演示完整链路。假设日志文件里有这样一段记录[Exception] EAccessViolation Module: ClientApp.exe Address: 0x0041A2B4 Call Stack: ClientApp.exe 0x0041A2B4 ClientApp.exe 0x0042C0D8 ClientApp.exe 0x0043809C如果没有 MAP 文件这个地址 0x0041A2B4 毫无含义。打开对应版本的详细 MAP 文件能找到这样一行映射关系0001:000002C0 TFormMain.DoRefresh 0041A2B4这就说明崩溃落在 DoRefresh 函数的偏移 0x2C0 处。然后往回看上面两层调用链一般就能把触发场景还原出来某个窗口关闭时触发 OnHideOnHide 调用了 DoRefreshDoRefresh 里访问了一个已经被释放的控件引用。整个过程只花二十分钟。没有 MAP 文件的话你可能得在反汇编里泡一下午还不一定看得明白。这里有一个额外提醒MAP 文件会泄露部分符号信息商业闭源项目在把 map 文件归档时要控制访问权限。它不应该出现在安装包里也不应该被签入公开仓库。5. EurekaLog 源码版接入的 4 个高频坑与排查5.1 IDE 装完就崩找不到运行期包现象设计期包安装完成后重启 IDE 时弹出“找不到包”或直接报 Access ViolationIDE 菜单里看不到 EurekaLog。原因设计期包依赖核心运行期包而你把 .bpl 输出到了不同目录IDE 在没有注册路径的前提下找不到运行期 .bpl。另一个常见原因是源码目录和编译输出目录不一致导致 IDE 在启动时加载设计期包成功但加载运行期包失败。解决把编译输出的目录统一加入 IDE 的 Library Path并且保证核心运行期包的输出目录和设计期包的输出目录都出现在“环境变量路径 / 系统 Path”中。最稳妥的做法是让两个包输出到同一个目录并把该目录加到 IDE 搜索路径的最前面。5.2 日志目录空钩子没生效或异常被 try/except 吞了现象程序正常跑故意触发异常后程序没有弹出 EurekaLog 对话框日志目录里也没有生成任何文件。原因第一种杀.dpr 里的初始化代码被后来的一次工程修改移除第二种原因是异常在一个 try/except 内部被捕获了EurekaLog 默认只记录未处理异常不会介入已经被业务代码处理掉的异常现场第三种原因是日志路径本身没有写权限它静默失败。解决先重新执行集成向导让工程文件恢复完整状态再在配置里把“记录被捕获异常”打开同时观察日志目录。需要注意打开记录被捕获异常后日志量会明显变大发布前要评估磁盘和上报通道的承载。权限问题在开发机上不容易暴露建议验证时把日志目录指向临时目录排除变量干扰。5.3 调用栈全是偏移忘带 MAP 文件现象日志能生成但调用栈全是十六进制地址没有任何函数名。原因编译时没有开启 Detailed Map或者虽然开了但程序崩溃时 EurekaLog 找不到 map 文件。源码版在发布构建里往往不会把 map 文件“带在内存里”它是在日志生成的那个瞬间读文件系统。解决回到工程选项中打开 Detailed Map重新构建。同时把 map 文件作为构建产物固定归档。这里还有一个容易忽略的点map 文件必须和 exe 的构建时间、构建版本严格对应不然地址偏移对不上反而会误导排查方向。版本归档习惯比开开关本身更重要。5.4 重复日志和另一个异常捕获库抢钩子现象同一个崩溃在日志目录里出现了两条记录一条是 EurekaLog 写出来的另一条格式明显来自其它异常捕获组件。原因项目里曾经集成过另一套异常捕获方案两个库都调用了 SetUnhandledExceptionFilter 或者都安装了异常钩子后安装的钩子没能正确把前一个钩子串起来导致两次处理。解决一个桌面程序只保留一个异常捕获框架。如果因为历史原因暂时无法移除旧库就把 EurekaLog 的初始化放在最后让它接管旧库处理的后续流程或者反过来让旧库调用链上的 handler 链接到 EurekaLog。无论如何上线前要专门做一次“双库并存”的崩溃测试用上面那个除零按钮验证最终只产生一份日志。6. 进阶把崩溃日志变成团队可复盘的事故基础设施做到前面五章你已经能从日志里定位崩溃函数了但一个人能定位和团队能复盘是两回事。我最后想分享的做法是把 EurekaLog 的日志输出对接到一个统一收集入口程序崩溃后生成本地日志文件再由一个独立进程或脚本把它推到内网收集服务。这样版本、崩溃点、出现次数、操作系统分布就都可以按字段聚合而不只是某个人在自己机器上翻文件。一个简单的上报脚本思路是这样#!/usr/bin/env bash # 假设 EurekaLog 已配置为崩落后生成文件并调用此脚本 LOG_FILE$1 APP_VERSION$2 # 内网崩溃收集服务域名换成你们自己的 curl -s -X POST http://crash-collector.internal/ingest \ -F appClientApp \ -F version$APP_VERSION \ -F logfile$LOG_FILE \ -o /dev/null这里的核心是让 EurekaLog 在写日志后触发一个外部脚本把文件和版本号一起 push 到统一服务端。版本号参数不要自己猜应该由构建系统从版本管理环境变量里读取保证每个日志能关联到对应代码基线。收到日志后按调用栈文本去重相同的崩溃点自动分组再按版本号对比就能看清“这个崩溃是新增还是存量”。我现在的习惯是每个桌面版本发布时把 exe、map 文件、EurekaLog 配置三样东西打包成一个构建存档固定存到内部归档目录。排查线上问题时先按版本号取 map 文件再拉日志整个链条十分钟打通。这套思路是从一次线上事故逼出来的当时崩溃日志有几百条但版本对不上最后只能靠猜。从那之后我就定了规矩没归档 map 文件的版本不上线。如果你正在给一个老 Delphi 项目做稳定性治理不用等所有问题查清后再引入 EurekaLog先在一个子模块上跑通捕获链路并留好日志积累两天数据再评估崩溃面。这个工具的核心价值不是减少崩溃而是让每一次崩溃都变成一份可追溯的证据。希望这份实战路径能帮你少走点弯路。本文还有配套的精品资源点击获取 EurekaLog源码版：程序漏洞分析检测与崩溃现场追踪
简介EurekaLog Enterprise 7.7.8.64(源码版)是面向 Delphi 与 CBuilder 开发者的程序漏洞分析检测工具核心价值在于捕获任意异常和内存泄露并在最终用户设备上生成包含文件、类、方法、行号的调用堆栈日志支持通过 Email 或 WEB 回传副本适合中高级桌面应用开发、发布后现场问题定位与企业级项目维护场景。资源以 rar 压缩包发布共 1494 个文件压缩包约 124.36MB文件类型覆盖 hpp/pas/dcu 等源码与编译单元dproj/dpk/dpr 等工程与包描述文件exe/dll 可执行程序与动态库obj/lib/a 等中间库文件chm/pdf 帮助文档以及 dfm 窗体、res/rc 资源文件、bpl 运行时包、ico 图标、bat 构建脚本等目录组织完整便于查阅和二次开发。此企业版附带完整源代码支持包括 10.2、10.3.2 在内的多个 Delphi 版本编译后程序体积仅增加约 300KB对运行时开销影响极小。目前已有 495 人学习下载借助源码可深入定制异常处理逻辑或将其集成到现有构建流程中显著提升软件质量与排错效率。1. EurekaLog 源码版程序漏洞分析检测不是抓 bug而是抓崩溃现场线上程序崩了最怕的往往不是崩溃本身而是用户回一句“刚才用着用着就没了”。EurekaLog 源码版就是专门解决这个场景的程序漏洞分析检测工具它平时几乎不占资源但在未处理异常触发的那一瞬间会把寄存器现场、调用栈、模块版本、系统信息全部写进日志让“本地复现不了”的崩溃变成“看日志十分钟能定位”的崩溃。7.7.8.64 这套源码版尤其适合有一线开发经验的团队因为你可以自己编译、自己定制上报逻辑而不是被安装版的黑匣子牵着走。这篇文章不打算吹它多神只讲怎么把源码版接进你的 Delphi 或 CBuilder 工程哪些配置决定你能拿到一份完整证据链哪些配置会让你只拿到一堆十六进制偏移。后面每一章都会落到可复现的命令和参数上包括我踩过的坑。2. 先弄明白 EurekaLog 在崩溃那一刻做了什么从 SEH 到源码版编译2.1 Windows 异常分发链路里的最后一个“接管点”要理解 EurekaLog 为什么能定位问题先要看懂 Windows 的异常分发。Delphi 的 try/except 捕获的是“在自己的调用层级里抛出的异常”这条链路通常在 VCL 的 Application.Run 消息循环内部。真正麻烦的是三种情况异常发生在工作线程、异常发生在第三方回调里、异常被某个深层 try/except 吞掉后状态已经错乱。这个时候程序可能不会立刻崩但内存已经被破坏后续任何操作都可能触发莫名其妙的异常。Windows 为每个线程都维护一套 SEH 结构化异常处理链如果当前线程的异常没有被任何 handler 处理系统最终会调用 SetUnhandledExceptionFilter 注册的过滤函数。EurekaLog 做事的本质就是在这个系统级的“最后接管点”上挂自己的处理函数。它不只拿到异常对象还能在栈还没被 unwind 之前读取寄存器上下文、模块加载列表、当前线程的调用栈这些信息加在一起才叫“崩溃现场”。所以它的定位和你写一百个 try/except 不一样。try/except 是你在“预期会有错”的地方加保险EurekaLog 是给“你根本没想到会错”的地方兜底。这也是为什么工具名称里强调“漏洞分析检测数据”它检测的不是代码里的逻辑 BUG而是异常发生的上下文。没有上下文光知道“这里除零了”没有任何意义因为除零前的数据来源才是真正的线索。2.2 为什么“源码版”值得放进版本库而不是用安装版EurekaLog 有安装版和源码版两种形态落地适配方案差别非常大。安装版是往开发机器上装一个 IDE 扩展图形界面点一点就能用适合个人快速试水。源码版则是把整套源码包拿回来自己编译成运行期包和设计期包再安装进 IDE。我一般会建议团队用源码版理由有三个。第一版本可控。三个开发成员如果各自装了不同小版本的安装版生成日志的调用栈格式可能不一样后续做日志聚合时字段对不上非常尴尬。源码版放进版本库所有成员用同一个源码包编译产出一致。第二可定制。安装版封装好的上报功能未必符合你的内网协议源码版可以直接改发送函数接你自己的崩溃收集服务。第三构建脚本可以无人值守编译不用每台机器手动点安装向导。下面是我在 Windows 上用命令行编译源码包的习惯写法注意文件名以你下载包里实际的核心包为准#!/usr/bin/env bash set -e # 改成你机器上的 RAD Studio 安装路径 DELPHI_BIN/c/Program Files (x86)/Embarcadero/Studio/21.0/bin # 改成你解压后的源码目录 EU_CORE_DIR/d/dev/third-party/eurekalog-src # 编译产物输出目录 OUT_DIR/d/build/bpl if [ ! -f $DELPHI_BIN/dcc32.exe ]; then echo 找不到 dcc32.exe请检查 DELPHI_BIN 路径 exit 1 fi cd $EU_CORE_DIR # 核心包文件名请替换成源码包里的实际 .dpk $DELPHI_BIN/dcc32.exe -B EurekaLogCore.dpk \ -D WIN32 -D RELEASE \ -U$EU_CORE_DIR \ -E$OUT_DIR \ -R$OUT_DIR这段脚本的核心逻辑是先把运行期包编译出来而不是直接安装。参数方面-B 表示全量重新编译避免旧产物干扰-D WIN32 -D RELEASE 是给包源码条件编译用的宏定义保证产物是发布版本-U 指定单元搜索路径让编译器能找到源码里的其它单元-E 指定 .bpl 输出目录-R 指定资源文件路径。编译完的 .bpl 文件会在后面安装设计期包时被引用。2.3 编译源码包之前先分辨三个模块第一次接触源码版的人最容易在“打开哪个工程文件”上翻车。一个完整源码包通常会分成三块一是核心运行期库它负责异常捕获、日志写入、上报动作程序发布时也要带着对应的运行时能力二是 IDE 设计期包它只在开发环境里存在负责给 Delphi 界面加 EurekaLog 菜单和项目属性页三是配置文件模板或工具程序用来生成默认的异常选项文件。我见过有人直接把设计期包装上但核心运行期库没编译结果 IDE 菜单有一编译项目就报缺少单元也有人只编译了核心库没装设计期包结果项目里无法打开配置页。正确顺序是先编译核心运行期库再安装设计期包。设计期包的编译方式跟核心包一样用 dcc32 编译对应的 .dpk只不过输出目录可以单独放方便 IDE 识别。安装时在 Delphi 的“Component”菜单里找到包安装入口把编译好的设计期 .bpl 添加进去IDE 会自动注册菜单项。注册完成后建议马上重启一次 IDE确认菜单加载没有报错再开始接项目。3. 把 EurekaLog 接入 Delphi 工程最小可用配置与第一次验证3.1 集成向导在 .dpr 里做了什么把 EurekaLog 接进项目常见做法是用 IDE 的集成向导而不是自己手写 uses 和初始化代码。向导会在你的项目工程文件 .dpr 里加入几个引用单元并在 begin...end. 块里插入两步初始化一步注册异常钩子一步设置日志参数。这段工程文件改动是“黑匣子”但你必须知道它长什么样才能在出问题时排查。一个被集成器修改后的 .dpr 示意如下program ClientApp; uses Vcl.Forms, umain in umain.pas {FormMain}, EurekaLogDtl; // 实际单元名以你源码包命名为准 {$R *.res} begin InitializeEurekaLog; // 钩子注册通常由集成器插入 Application.Initialize; Application.MainFormOnTaskBar : True; Application.CreateForm(TFormMain, FormMain); Application.Run; FinalizeEurekaLog; // 反注册避免程序退出时二次崩溃 end.注意一点上面这段里的单元名和过程名只是示意不同版本源码包的命名可能不同。你要关注的是它在工程文件里的位置——初始化代码必须在 Application.Initialize 之前执行。如果放在后面钩子就漏掉了 VCL 启动阶段发生的早期异常。反注册代码放在 Application.Run 之后能让崩溃发生在退出阶段时也能被接住。如果你发现集成向导没有正确插入这两处别急着手动补先确认设计期包安装是否成功否则你补了源码包里的逻辑IDE 菜单还是不会显示配置页。3.2 验证钩子一段不可能正常执行到结束的代码接入后的第一件事不是写业务而是制造一个未处理异常验证钩子。写一个按钮点击后抛出一个异常正常情况下程序会弹系统错误框如果 EurekaLog 钩子生效你会看到它的异常对话框以及日志文件落在配置好的目录里。procedure TFormMain.ButtonForceCrashClick(Sender: TObject); var A: Integer; B: Integer; R: Double; begin A : 1; B : 0; // 故意触发除零异常用于验证异常捕获钩子是否生效 R : A / B; // 如果走到了这里说明异常没有抛出来就要检查编译选项了 ShowMessage(未触发异常请检查优化选项); end;这段代码成功被捕获的前提是Delphi 编译选项里的 Optimization 没有把除零优化掉并且 EurekaLog 钩子确实注册了。如果你跑起来后发现弹的是系统对话框而不是 EurekaLog 的日志对话框第一步先回工程文件里看初始化代码是否被删过第二步看 EurekaLog 配置里是否关闭了“未处理异常显示”。不要一上来就怀疑工具不好用九成情况是工程文件没改完整。3.3 参数怎么定对话框、日志路径、静默模式钩子验证通过后就要按发布环境配置参数了。开发期和发布期的配置应该完全分开这也是很多人容易忽略的地方。开发期建议打开异常对话框以最简单的方式把日志存成本地文件方便调试发布期建议关闭异常对话框改成静默写入日志后自动上报避免终端用户看到陌生的技术弹窗。下面这张表是我常用的参数基线不同项目可以微调。参数项开发期建议值发布期建议值说明异常对话框开启关闭发布期开启会让用户困惑也容易截图后被当作系统 bug日志存储目录项目目录下临时 log 目录%LocalAppData% 下按程序名建目录避免写安装目录导致权限问题日志文件数量不限制按天数轮转留最近 30 天防止日志无限增长塞满磁盘上报方式不启用HTTP 推送到内网收集服务上报逻辑格外依赖源码版的定制能力内嵌调用栈开启开启没有调用栈的日志几乎等于废纸这里最值得强调的是日志目录。许多桌面软件跑在装有防护软件的环境里安装目录是受保护目录写文件会被重定向或者直接拦截。把日志写到 %LocalAppData% 下的独立子目录虽然不是绝对安全但权限问题会少很多。如果程序跑在服务环境还要额外给运行账号配置目录写权限。4. 从日志到代码行MAP 文件、调用栈与版本归档4.1 无符号调用栈为什么不能直接定位EurekaLog 日志里的调用栈最初是一串“模块名 十六进制地址”比如 ClientApp.exe 0x0041A2B4。这种形式只有两个信息崩在哪个可执行文件里以及崩在可执行文件哪个偏移位置。没有符号信息的话你这串地址对不上任何函数名等于拿到了一个保险箱但没钥匙。符号信息的来源是编译器的 MAP 文件。Delphi 在链接的时候可以根据编译单元的代码段偏移生成地址到函数名的映射表。有了 MAP 文件EurekaLog 才能在日志里直接写出“TFormMain.DoRefresh 0x04”这样的调用栈。所以配置 EurekaLog 本身只解决“东西崩了现场被抓住了”能不能快速看出现场是撞在哪个函数上取决于你编译项目时有没有留下符号表。很多团队发布程序时习惯把 “Detailed MAP file” 选项关掉理由是“减小体积”。实际上 MAP 文件不需要打进安装包它只在分析日志时被开发者使用应该作为构建产物归档到服务器上而不是跟着安装包分发。关掉这个选项省下的那点编译时间会在灾难发生后百倍赔回去。4.2 三个必开编译选项让调用栈“点名道姓”在 Delphi 工程选项里和 EurekaLog 配合最低要求开三个开关。第一Linker 页面的 Map File 要选 Detailed这样才能得到包含函数名和入口偏移的完整映射表。第二Compiler 页面的 Debug Information 要打开它会让编译器生成调试符号。第三在 Running Environment 或对应页面里开启堆栈帧指针生成这对调用栈的还原准确度影响很大尤其是在优化开启的发布构建里。这三个开关开完之后编译产物目录里会多出一个 .map 文件。EurekaLog 在写日志时可以读取这个 MAP 文件把地址翻译成函数名如果你用的是集成向导通常它会自动寻找 map 文件。为了保险我习惯把 map 文件拷贝到和 exe 同一个目录再手动运行一次崩溃验证。确认日志里显示的不再是裸地址而是函数名加偏移。这一步通过后才真正具备线上排查条件。4.3 一次“查不到原因”的线上崩溃排查用一个简化的日志片段演示完整链路。假设日志文件里有这样一段记录[Exception] EAccessViolation Module: ClientApp.exe Address: 0x0041A2B4 Call Stack: ClientApp.exe 0x0041A2B4 ClientApp.exe 0x0042C0D8 ClientApp.exe 0x0043809C如果没有 MAP 文件这个地址 0x0041A2B4 毫无含义。打开对应版本的详细 MAP 文件能找到这样一行映射关系0001:000002C0 TFormMain.DoRefresh 0041A2B4这就说明崩溃落在 DoRefresh 函数的偏移 0x2C0 处。然后往回看上面两层调用链一般就能把触发场景还原出来某个窗口关闭时触发 OnHideOnHide 调用了 DoRefreshDoRefresh 里访问了一个已经被释放的控件引用。整个过程只花二十分钟。没有 MAP 文件的话你可能得在反汇编里泡一下午还不一定看得明白。这里有一个额外提醒MAP 文件会泄露部分符号信息商业闭源项目在把 map 文件归档时要控制访问权限。它不应该出现在安装包里也不应该被签入公开仓库。5. EurekaLog 源码版接入的 4 个高频坑与排查5.1 IDE 装完就崩找不到运行期包现象设计期包安装完成后重启 IDE 时弹出“找不到包”或直接报 Access ViolationIDE 菜单里看不到 EurekaLog。原因设计期包依赖核心运行期包而你把 .bpl 输出到了不同目录IDE 在没有注册路径的前提下找不到运行期 .bpl。另一个常见原因是源码目录和编译输出目录不一致导致 IDE 在启动时加载设计期包成功但加载运行期包失败。解决把编译输出的目录统一加入 IDE 的 Library Path并且保证核心运行期包的输出目录和设计期包的输出目录都出现在“环境变量路径 / 系统 Path”中。最稳妥的做法是让两个包输出到同一个目录并把该目录加到 IDE 搜索路径的最前面。5.2 日志目录空钩子没生效或异常被 try/except 吞了现象程序正常跑故意触发异常后程序没有弹出 EurekaLog 对话框日志目录里也没有生成任何文件。原因第一种杀.dpr 里的初始化代码被后来的一次工程修改移除第二种原因是异常在一个 try/except 内部被捕获了EurekaLog 默认只记录未处理异常不会介入已经被业务代码处理掉的异常现场第三种原因是日志路径本身没有写权限它静默失败。解决先重新执行集成向导让工程文件恢复完整状态再在配置里把“记录被捕获异常”打开同时观察日志目录。需要注意打开记录被捕获异常后日志量会明显变大发布前要评估磁盘和上报通道的承载。权限问题在开发机上不容易暴露建议验证时把日志目录指向临时目录排除变量干扰。5.3 调用栈全是偏移忘带 MAP 文件现象日志能生成但调用栈全是十六进制地址没有任何函数名。原因编译时没有开启 Detailed Map或者虽然开了但程序崩溃时 EurekaLog 找不到 map 文件。源码版在发布构建里往往不会把 map 文件“带在内存里”它是在日志生成的那个瞬间读文件系统。解决回到工程选项中打开 Detailed Map重新构建。同时把 map 文件作为构建产物固定归档。这里还有一个容易忽略的点map 文件必须和 exe 的构建时间、构建版本严格对应不然地址偏移对不上反而会误导排查方向。版本归档习惯比开开关本身更重要。5.4 重复日志和另一个异常捕获库抢钩子现象同一个崩溃在日志目录里出现了两条记录一条是 EurekaLog 写出来的另一条格式明显来自其它异常捕获组件。原因项目里曾经集成过另一套异常捕获方案两个库都调用了 SetUnhandledExceptionFilter 或者都安装了异常钩子后安装的钩子没能正确把前一个钩子串起来导致两次处理。解决一个桌面程序只保留一个异常捕获框架。如果因为历史原因暂时无法移除旧库就把 EurekaLog 的初始化放在最后让它接管旧库处理的后续流程或者反过来让旧库调用链上的 handler 链接到 EurekaLog。无论如何上线前要专门做一次“双库并存”的崩溃测试用上面那个除零按钮验证最终只产生一份日志。6. 进阶把崩溃日志变成团队可复盘的事故基础设施做到前面五章你已经能从日志里定位崩溃函数了但一个人能定位和团队能复盘是两回事。我最后想分享的做法是把 EurekaLog 的日志输出对接到一个统一收集入口程序崩溃后生成本地日志文件再由一个独立进程或脚本把它推到内网收集服务。这样版本、崩溃点、出现次数、操作系统分布就都可以按字段聚合而不只是某个人在自己机器上翻文件。一个简单的上报脚本思路是这样#!/usr/bin/env bash # 假设 EurekaLog 已配置为崩落后生成文件并调用此脚本 LOG_FILE$1 APP_VERSION$2 # 内网崩溃收集服务域名换成你们自己的 curl -s -X POST http://crash-collector.internal/ingest \ -F appClientApp \ -F version$APP_VERSION \ -F logfile$LOG_FILE \ -o /dev/null这里的核心是让 EurekaLog 在写日志后触发一个外部脚本把文件和版本号一起 push 到统一服务端。版本号参数不要自己猜应该由构建系统从版本管理环境变量里读取保证每个日志能关联到对应代码基线。收到日志后按调用栈文本去重相同的崩溃点自动分组再按版本号对比就能看清“这个崩溃是新增还是存量”。我现在的习惯是每个桌面版本发布时把 exe、map 文件、EurekaLog 配置三样东西打包成一个构建存档固定存到内部归档目录。排查线上问题时先按版本号取 map 文件再拉日志整个链条十分钟打通。这套思路是从一次线上事故逼出来的当时崩溃日志有几百条但版本对不上最后只能靠猜。从那之后我就定了规矩没归档 map 文件的版本不上线。如果你正在给一个老 Delphi 项目做稳定性治理不用等所有问题查清后再引入 EurekaLog先在一个子模块上跑通捕获链路并留好日志积累两天数据再评估崩溃面。这个工具的核心价值不是减少崩溃而是让每一次崩溃都变成一份可追溯的证据。希望这份实战路径能帮你少走点弯路。本文还有配套的精品资源点击获取