Agile.NET反篡改怎么启用Agile.NET校验失败导致启动退出怎么查，这个题目里最容易混淆的一点，是把代码保护里的各种混淆功能和许可证防篡改校验当成同一件事。就SecureTeam公开文档来看，真正直接对应“防篡改校验”的主线，是Agile.net Copy Protection里的公私钥、许可证签名和运行时【Validate】校验流程，而不是单独一个孤立的“反篡改开关”。也就是说，你要启用的核心不是随手勾一个选项，而是先把项目接入Copy Protection，再让程序在启动或关键功能入口做许可证校验。
一、Agile.NET反篡改怎么启用
真正要把这套校验链路接起来，第一步不是先发许可证，而是先让项目具备识别和验证许可证的能力。官方文档给出的标准做法，就是先跑项目向导，把密钥、运行库引用和校验模板都接进现有项目里。
1、先在licensing页面运行【Protect VS.NET Project】
打开Agile.NET后，先切到licensing页面，然后点主功能区里的【Protect VS.NET Project】。官方说明里写得很清楚，这个向导就是给Visual Studio项目接入Copy Protection用的，会把后面需要的关键内容一次性准备好。
2、创建自己的密钥对，不要直接沿用默认密钥
向导运行后，会让你创建或选择一套license keys。官方API文档明确说明，DefaultLicenseKey不能直接用于保护正式软件，正式项目应该自己新建密钥。因为这套密钥后面既要负责许可证签名，也要负责运行时验证，前后不一致就会直接导致校验失败。
3、确认项目里已经加上运行库和公钥文件
项目向导完成后，官方说明它会自动给项目加上AgileDotNet.Licensing.dll引用、示例校验代码模板，以及公钥相关文件。到这一步，项目才算真正具备了“验证许可证有没有被改动、是不是由正确密钥签发”的基础能力。
4、把【Validate】放到真正需要保护的类里
官方文档建议，在需要保护的类里加入【Validate】调用。它不会强制你只能在程序加载时校验，你可以自己决定是在启动入口、主窗口初始化，还是某个关键功能入口去做。只是你一旦把它放得很靠前，许可证一旦无效，程序就很可能表现成刚启动就退出。
5、再到licensing页面创建正式许可证
项目接好以后，再回到licensing页面，从锁规则区域选择Time、Trial、Mac Address、Feature之类的锁，配置完再点创建许可证。官方文档特别强调，创建许可证时选用的签名密钥，必须和前面项目向导里接入项目的那一套密钥一致，否则程序能读到许可证，也不会把它认成有效许可证。
二、Agile.NET校验失败导致启动退出怎么查
这类问题真正难查的地方，不是许可证一定坏了，而是它经常在最早的启动链路里触发，所以外在表现非常像“程序一打开就闪退”。排查时最有效的思路，不是先重做许可证，而是先把启动阶段的校验动作拆开，看它到底卡在找文件、验签名，还是验锁规则。
1、先看【Validate】是不是放在启动最前面
官方文档写得很明确，Agile.NET不限制校验时机，所以如果你把【Validate】直接写在主程序入口、主窗体构造或核心服务初始化里，一旦失败，程序还没来得及给出业务提示就可能直接中断。排查第一步先看位置，往往比先怀疑许可证格式更有效。
2、先查【.LIC】文件是不是放对了地方
【Validate】默认会先在应用程序目录里找所有以.LIC结尾的许可证文件，再逐个验证。官方同时说明，你也可以通过【AddSearchDirectory】补充额外搜索目录，但它只会加入当前目录，不会递归扫描子目录。很多“启动即退”其实不是许可证失效，而是部署后文件放错层级，程序根本没扫到。
3、再查签名密钥是不是前后不一致
官方文档反复强调，许可证是用私钥签发的，运行时则用项目内的公钥去验证真伪和完整性。只要项目接入时用的是一套密钥，许可证生成时又换成另一套，或者中途替换过公钥文件，最终表现就会是校验失败，程序无法继续运行。
4、把异常先接住，不要让程序直接退出
【Validate】有带allowExceptions参数的重载。官方说明里写得很清楚，找不到有效许可证时，默认会抛出LicenseNotFoundException；如果把allowExceptions设为false，就会返回null。排查阶段更稳的做法，是先让程序别直接崩掉，把返回结果、扫描目录和当前许可证文件名记进日志，再继续往下缩小范围。
5、如果报的是LicenseKeyNotFoundException，就去查是不是误用了私钥相关逻辑
官方API文档说明，LicenseKeyNotFoundException通常表示系统找不到AgileDotNet.Licensing.PrivateKey.bin。另一个相关文档又明确提醒，在生产环境里通常没有license key file，所以如果你的运行时代码去读取不该在正式环境使用的密钥信息，就可能把问题伪装成“反篡改校验失败”。这类问题本质上不是许可证文件坏了，而是运行时代码混进了不该带到生产环境的私钥依赖。
三、Agile.NET启动退出时怎么更快缩小范围
这类故障最怕一上来全改。更稳的办法，是把“找许可证”“验签名”“验锁规则”“网络许可”这几段拆开，一段一段确认。这样查出来的结果更清楚，后面也更容易固化成发布流程。
1、先分清是没找到许可证，还是找到了但没通过验证
官方文档说明，【Validate】会先找许可证，再逐个检查其中的锁规则，只有签名有效、锁条件也满足时才会返回有效许可证。也就是说，程序启动退出不一定说明文件缺失，也可能是Time、Trial、Mac Address或Feature这些限制条件没有通过。
2、额外目录和网络许可要分开查
如果你不是把许可证放在程序目录，而是放在AppData、共享目录或客户指定目录，就要显式调用【AddSearchDirectory】。如果你接的是网络许可，还要再单独检查网络许可服务，因为官方文档说明它有独立日志，默认写在服务程序目录，没有写权限时会写到%LocalAppData%SecureTeamNetworkLicenseService。
3、把最终可用配置固化成发布模板
问题查清后，不要只修这一次。更稳的收口方式，是把哪套密钥用于项目接入、哪套锁规则用于发证、许可证放在哪个目录、启动阶段是否允许异常直接抛出，这几项一起固化到发布流程里。这样下次再发版时，就不会因为换了目录、换了密钥或改了启动顺序，又把同一类问题重新带回来。
总结
Agile.NET反篡改怎么启用Agile.NET校验失败导致启动退出怎么查，核心并不是去找一个名字叫“反篡改”的单独开关，而是把Agile.net Copy Protection的项目向导、密钥体系、许可证签名和【Validate】校验链路接完整。真遇到启动即退时，先查【Validate】放置位置，再查【.LIC】目录，再查密钥是否一致，最后用allowExceptions为false的方式把程序留在可记录状态，通常就能把问题很快圈定下来。
