C++ TWAIN扫描编程：绕过驱动UI实现静默扫描与参数控制-平芜编程栈

1. 项目概述：为什么需要深入TWAIN扫描设置？

如果你在C++项目中处理过图像扫描，尤其是需要连接物理扫描仪时，大概率绕不开TWAIN这个“古老”但生命力顽强的标准。很多开发者，尤其是刚接触硬件交互的朋友，可能会觉得调用一个扫描接口，拿到图片数据就完事了。但现实往往是，弹出的那个默认扫描对话框，其界面、功能、甚至稳定性，都完全依赖于扫描仪厂商提供的驱动，你几乎无法控制。当你的应用需要定制化的扫描流程——比如自动设置分辨率、色彩模式、扫描区域，或者实现无人值守的批量扫描——你就会发现，仅仅调用DSM_Entry打开默认界面是远远不够的。

这就是我们今天要深入探讨的核心：绕过或深度定制TWAIN驱动的用户界面，通过C++代码直接、精确地控制扫描仪的每一个参数。这不仅仅是调用几个API那么简单，它涉及到对TWAIN协议状态机的精准把控、对大量复杂数据结构的理解，以及对不同厂商驱动“怪癖”的应对。网上能找到的代码片段，大多只展示了最简单的“打开-获取-关闭”流程，一旦涉及到具体的扫描设置，比如如何设置真正的“黑白二值”模式而不是驱动显示的“灰度”，如何以编程方式选择扫描源（在多台扫描仪的场景下），往往语焉不详。我将结合一个实战项目中的经验，拆解从建立连接到完成一次精细化扫描的全过程，并分享那些在官方文档里找不到的“坑”和技巧。

2. TWAIN协议基础与状态机精要

在动手写代码之前，必须理解TWAIN的工作模型。它不是简单的函数调用，而是一个基于状态机的对话协议。你可以把应用程序（你的C++程序）和扫描仪驱动（DataSource）的交互，想象成两个人打电话，必须按照特定的“礼仪”和步骤进行，否则对方（驱动）可能直接挂断（返回错误）。

2.1 核心角色与状态流转

TWAIN定义了三个主要角色：

应用（Application）：我们的C++程序。
源管理器（Source Manager, SM）：一个由TWAIN工作组提供的动态库（twain_32.dll或twaindsm.dll），它是应用和数据源之间的中介和路由器。所有通信都必须通过源管理器。
数据源（DataSource, DS）：具体的扫描仪驱动。

其工作状态机是核心中的核心，主要状态包括：

状态1：预加载（Pre-Session）：应用启动，尚未加载源管理器。
状态2：源管理器加载（Source Manager Loaded）：应用成功加载了TWAIN源管理器动态库。
状态3：源管理器打开（Source Manager Open）：应用打开了与源管理器的会话。
状态4：数据源打开（DataSource Open）：应用通过源管理器，打开了与特定扫描仪驱动的会话。只有进入这个状态，你才能进行扫描设置。
状态5：就绪（Enabled）：数据源界面被启用（如果显示UI），或者准备就绪（如果不显示UI）。这是发起扫描（MSG_XFERREADY）的前置状态。
状态6/7：传输中（Transferring）：正在传输图像数据。

关键理解：很多设置操作，比如获取或设置扫描分辨率（ICAP_XRESOLUTION,ICAP_YRESOLUTION），必须在状态4（DataSource Open）下进行。试图在状态3之前做这些操作，会得到TWRC_FAILURE。因此，你的代码结构必须严格遵循状态流转。

2.2 数据类型与通信机制

TWAIN使用一种名为TW_前缀的结构体来传递所有信息。最核心的通信函数是DSM_Entry，它像一个万能邮差，根据你传递的DG_（数据组）、DAT_（数据参数类型）和MSG_（消息）来执行不同操作。

例如，打开一个数据源的调用逻辑是：

TW_UINT16 rc = ::DSM_Entry( &m_appId, // pOrigin: 应用标识 nullptr, // pDest: 初始为null，指向源管理器 DG_CONTROL, // Data Group: 控制类操作 DAT_IDENTITY, // Data Argument Type: 操作对象是“身份” MSG_OPENDS, // Message: 打开数据源 (TW_MEMREF)&m_sourceIdentity // 传递一个已选中的数据源身份结构 );

这里，DG_CONTROL表示这是一个控制指令，DAT_IDENTITY表示我们在操作一个“身份”对象（可以是源管理器或数据源），MSG_OPENDS是“打开数据源”的具体指令。理解这种“三层”参数（组、类型、消息）的思维模式，是灵活使用TWAIN API的关键。

3. 项目实战：C++扫描设置详解

下面，我将以一个实际的C++类TwainScanner的部分实现为例，分步解析如何实现精细化扫描设置。我们假设的目标是：静默扫描（不显示驱动UI），设置扫描区域为A4纸大小，300 DPI，彩色模式，并一次性扫描多页（如果扫描仪支持）。

3.1 环境准备与初始化

首先，你需要获取TWAIN头文件（twain.h）和库文件。通常，你可以从TWAIN工作组官网下载最新的开发包。在项目中包含头文件，并确保链接时能找到twain_32.lib（静态导入库），运行时系统路径下存在twain_32.dll。

初始化应用标识（TW_IDENTITY）是第一步，它告诉系统“你是谁”。

bool TwainScanner::Init() { memset(&m_appId, 0, sizeof(TW_IDENTITY)); m_appId.Id = 0; // 必须为0 m_appId.Version.MajorNum = 2; m_appId.Version.MinorNum = 0; m_appId.Version.Language = TWLG_ENGLISH_USA; m_appId.Version.Country = TWCY_USA; strcpy(m_appId.Version.Info, "MyScanApp 1.0"); m_appId.ProtocolMajor = TWON_PROTOCOLMAJOR; m_appId.ProtocolMinor = TWON_PROTOCOLMINOR; m_appId.SupportedGroups = DG_IMAGE | DG_CONTROL; strcpy(m_appId.Manufacturer, "MyCompany"); strcpy(m_appId.ProductFamily, "DocumentMgmt"); strcpy(m_appId.ProductName, "TwainScannerModule"); // 加载并打开源管理器 m_hTwainDLL = ::LoadLibraryA("twain_32.dll"); if (!m_hTwainDLL) { // 尝试twaindsm.dll (新版) m_hTwainDLL = ::LoadLibraryA("twaindsm.dll"); if (!m_hTwainDLL) return false; } auto pDSM_Entry = (DSMENTRYPROC)::GetProcAddress(m_hTwainDLL, "DSM_Entry"); if (!pDSM_Entry) return false; TW_UINT16 rc = pDSM_Entry(&m_appId, nullptr, DG_CONTROL, DAT_PARENT, MSG_OPENDSM, (TW_MEMREF)&m_hParentWnd); return (rc == TWRC_SUCCESS); }

注意：m_hParentWnd是你的应用窗口句柄。即使你打算无UI扫描，也需要一个有效的窗口句柄，因为TWAIN驱动在内部可能需要消息循环。通常传入应用主窗口句柄即可。

3.2 选择与打开数据源

通常，我们会提供一个列表让用户选择扫描仪。但为了实现自动化，我们需要能通过程序指定扫描仪。一种常见做法是枚举所有数据源，然后根据产品名称（ProductName）或制造商（Manufacturer）来匹配。

bool TwainScanner::SelectSource(const std::string& preferredName) { TW_IDENTITY sourceIdentity = {0}; // 首先获取默认源 TW_UINT16 rc = CallDSM(nullptr, DG_CONTROL, DAT_IDENTITY, MSG_GETDEFAULT, (TW_MEMREF)&sourceIdentity); if (rc == TWRC_SUCCESS && !preferredName.empty()) { // 如果指定了偏好名称，则枚举所有源进行匹配 rc = CallDSM(nullptr, DG_CONTROL, DAT_IDENTITY, MSG_GETFIRST, (TW_MEMREF)&sourceIdentity); while (rc == TWRC_SUCCESS) { if (preferredName == sourceIdentity.ProductName) { m_sourceIdentity = sourceIdentity; // 找到匹配的源 break; } rc = CallDSM(nullptr, DG_CONTROL, DAT_IDENTITY, MSG_GETNEXT, (TW_MEMREF)&sourceIdentity); } if (m_sourceIdentity.Id == 0) { // 没找到匹配的，回退到默认源 rc = CallDSM(nullptr, DG_CONTROL, DAT_IDENTITY, MSG_GETDEFAULT, (TW_MEMREF)&m_sourceIdentity); } } else if (rc == TWRC_SUCCESS) { m_sourceIdentity = sourceIdentity; // 使用默认源 } return (rc == TWRC_SUCCESS && m_sourceIdentity.Id != 0); } bool TwainScanner::OpenSource() { if (m_sourceIdentity.Id == 0) { if (!SelectSource("")) return false; // 使用默认源 } // 此时处于状态3（SM Open），接下来打开数据源，进入状态4（DS Open） TW_UINT16 rc = CallDSM(nullptr, DG_CONTROL, DAT_IDENTITY, MSG_OPENDS, (TW_MEMREF)&m_sourceIdentity); m_bSourceOpen = (rc == TWRC_SUCCESS); return m_bSourceOpen; }

CallDSM是一个对DSM_Entry的简单封装，用于统一错误处理。成功打开数据源后，我们才真正拿到了扫描仪的“控制权”，可以开始进行详细的设置了。

3.3 核心扫描参数设置详解

这是本文的重点。我们将通过DAT_CAPABILITY来获取和设置能力（Capabilities）。每个能力由一个CAP_（如CAP_FEEDERENABLED）或ICAP_（如图像相关能力，如ICAP_PIXELTYPE）标识。

3.3.1 设置无用户界面模式

这是实现静默扫描的第一步。我们需要设置CAP_INDICATORS为FALSE（不显示进度指示器，但并非所有驱动支持），而最关键的是在启用数据源时传递TW_USERINTERFACE结构，并设置ShowUI为FALSE。

bool TwainScanner::EnableSource(bool showUI) { if (!m_bSourceOpen) return false; TW_USERINTERFACE ui = {0}; ui.ShowUI = showUI ? TRUE : FALSE; ui.hParent = m_hParentWnd; // 即使不显示UI，也需要有效句柄 // ModalUI 通常设为TRUE，即使ShowUI为FALSE ui.ModalUI = TRUE; TW_UINT16 rc = CallDSM(&m_sourceIdentity, DG_CONTROL, DAT_USERINTERFACE, MSG_ENABLEDS, (TW_MEMREF)&ui); return (rc == TWRC_SUCCESS); }

调用MSG_ENABLEDS后，如果ShowUI为FALSE且驱动支持，状态会直接进入“就绪”（状态5），不会弹出任何窗口。注意：并非所有扫描仪驱动都支持无UI模式。一些老旧的或功能简单的驱动可能强制弹出界面。在实际项目中，这是一个重要的兼容性测试点。

3.3.2 设置扫描区域（ICAP_SUPPORTEDSIZES & ICAP_FRAMES）

扫描区域设置有两个常见途径：

使用标准纸张尺寸：通过ICAP_SUPPORTEDSIZES能力，可以设置如TWSS_A4、TWSS_LETTER等。这是一种简单的方式，但精度不高，取决于驱动对纸张尺寸的定义。
自定义帧（Frame）：通过ICAP_FRAMES能力，可以设置一个精确的矩形区域（单位为英寸，使用TW_FRAME结构）。这是更推荐的方式。

bool TwainScanner::SetScanArea(float left, float top, float right, float bottom) { // 首先尝试设置自定义帧 TW_FRAME frame = {0}; frame.Left = TW_FIX32::FromFloat(left); frame.Top = TW_FIX32::FromFloat(top); frame.Right = TW_FIX32::FromFloat(right); frame.Bottom = TW_FIX32::FromFloat(bottom); TW_CAPABILITY cap = {0}; cap.Cap = ICAP_FRAMES; cap.ConType = TWON_ONEVALUE; cap.hContainer = GlobalAlloc(GHND, sizeof(TW_ONEVALUE) + sizeof(TW_FRAME)); if (!cap.hContainer) return false; TW_ONEVALUE* pVal = (TW_ONEVALUE*)GlobalLock(cap.hContainer); pVal->ItemType = TWTY_FRAME; memcpy(&pVal->Item, &frame, sizeof(TW_FRAME)); GlobalUnlock(cap.hContainer); TW_UINT16 rc = CallDSM(&m_sourceIdentity, DG_CONTROL, DAT_CAPABILITY, MSG_SET, (TW_MEMREF)&cap); GlobalFree(cap.hContainer); if (rc != TWRC_SUCCESS) { // 如果自定义帧失败，回退到设置A4纸张 return SetOneValueCapability(ICAP_SUPPORTEDSIZES, TWTY_UINT16, TWSS_A4); } return true; }

TW_FIX32是TWAIN用于表示定点数的结构，FromFloat是一个辅助函数，用于将浮点数转换为TW_FIX32。TWON_ONEVALUE表示我们设置的是单一值。这里有一个大坑：ICAP_FRAMES的ItemType必须是TWTY_FRAME，而不是TWTY_FIX32或其他。错误的数据类型是导致设置失败的常见原因。

3.3.3 设置分辨率与色彩模式

分辨率和色彩模式是影响扫描质量和文件大小的关键参数。

bool TwainScanner::SetResolution(int xDPI, int yDPI) { // 通常X和Y分辨率设置为相同值 if (!SetOneValueCapability(ICAP_XRESOLUTION, TWTY_FIX32, TW_FIX32::FromFloat((float)xDPI))) { return false; } return SetOneValueCapability(ICAP_YRESOLUTION, TWTY_FIX32, TW_FIX32::FromFloat((float)yDPI)); } bool TwainScanner::SetPixelType(TW_INT16 pixelType) { // pixelType: TWPT_BW (黑白二值), TWPT_GRAY (灰度), TWPT_RGB (彩色) return SetOneValueCapability(ICAP_PIXELTYPE, TWTY_UINT16, pixelType); }

SetOneValueCapability是一个封装好的辅助函数，用于设置TWON_ONEVALUE类型的单值能力。这里要特别注意色彩模式的陷阱：你设置了TWPT_BW（黑白二值），但有些扫描仪驱动在硬件层面可能只支持灰度扫描，然后通过二值化算法模拟黑白。这会导致扫描速度变慢，或者二值化效果不佳。更可靠的做法是：

先获取ICAP_PIXELTYPE的支持值列表（MSG_GETwithTW_ARRAYorTW_ENUMERATION）。
检查TWPT_BW是否在支持列表中。
如果支持，直接设置；如果不支持，而你又需要黑白图像，可以考虑设置TWPT_GRAY，然后在软件端进行二值化处理，这样可控性更高。

3.3.4 设置进纸器与多页扫描

对于文档扫描，自动进纸器（ADF）是提高效率的关键。

bool TwainScanner::SetupFeeder(bool enableFeeder, bool duplex) { // 1. 检查是否支持进纸器 TW_CAPABILITY cap; if (!GetCapability(CAP_FEEDERENABLED, cap)) { return false; // 不支持进纸器 } // 2. 启用或禁用进纸器 if (!SetOneValueCapability(CAP_FEEDERENABLED, TWTY_BOOL, enableFeeder ? TRUE : FALSE)) { return false; } if (enableFeeder) { // 3. 设置进纸器已加载纸张 if (!SetOneValueCapability(CAP_FEEDERLOADED, TWTY_BOOL, TRUE)) { // 有些驱动不需要设置这个，忽略错误 } // 4. 设置是否双面扫描 if (duplex) { // 先检查是否支持双面 if (GetCapability(CAP_DUPLEXENABLED, cap)) { SetOneValueCapability(CAP_DUPLEXENABLED, TWTY_BOOL, TRUE); } } // 5. 设置扫描结束后不进纸（等待更多指令），便于控制 SetOneValueCapability(CAP_AUTOFEED, TWTY_BOOL, FALSE); } return true; }

重要心得：CAP_AUTOFEED这个能力非常关键。如果设置为TRUE，当进纸器中有多页纸时，驱动会在扫描完一页后自动进下一页，直到所有页扫完，然后一次性返回所有图像。这看起来方便，但一旦中间卡纸或出错，整个任务就失败了。我推荐将其设置为FALSE，然后通过循环调用MSG_ENABLEDS和图像传输，实现“扫描一页，处理一页，再扫下一页”的流程。这样容错性更高，内存占用也更可控。

3.4 图像传输与处理

设置完成后，就可以发起扫描了。流程是：MSG_ENABLEDS-> 等待MSG_XFERREADY事件 -> 循环调用MSG_GET获取图像信息 -> 调用MSG_GET传输图像数据 -> 处理数据 -> 结束传输。

std::vector<ImageData> TwainScanner::AcquireImages() { std::vector<ImageData> images; if (!EnableSource(false)) { // 无UI模式启用 return images; } // 进入消息循环，等待TWAIN事件。这是一个简化示例，实际中需要集成到你的窗口消息循环中。 MSG msg; while (GetMessage(&msg, nullptr, 0, 0)) { if (m_bTransferDone) break; // 传输完成标志 // 通常，TWAIN驱动会发送一个自定义消息（如MSG_XFERREADY）到你的窗口过程 // 这里假设我们通过一个标志或回调来模拟 if (/* 检查到XFERREADY事件 */) { TW_PENDINGXFERS pendingXfers = {0}; do { TW_IMAGEINFO imageInfo = {0}; TW_UINT16 rc = CallDSM(&m_sourceIdentity, DG_IMAGE, DAT_IMAGEINFO, MSG_GET, (TW_MEMREF)&imageInfo); if (rc != TWRC_SUCCESS) break; // 根据imageInfo分配缓冲区 TW_SETUPMEMXFER memXfer = {0}; rc = CallDSM(&m_sourceIdentity, DG_CONTROL, DAT_SETUPMEMXFER, MSG_GET, (TW_MEMREF)&memXfer); // 开始内存传输 TW_IMAGEMEMXFER memXferData = {0}; memXferData.Memory.Flags = TWMF_APPOWNS | TWMF_POINTER; memXferData.Memory.Length = memXfer.Preferred; memXferData.Memory.TheMem = malloc(memXfer.Preferred); while (true) { rc = CallDSM(&m_sourceIdentity, DG_IMAGE, DAT_IMAGEMEMXFER, MSG_GET, (TW_MEMREF)&memXferData); if (rc == TWRC_SUCCESS) { // 将memXferData.TheMem中的数据追加到当前图像的缓冲区 ProcessImageChunk(memXferData); } else if (rc == TWRC_XFERDONE) { // 一张图片传输完成 ImageData img = FinalizeCurrentImage(); images.push_back(img); break; } else { // 错误或取消 break; } } free(memXferData.Memory.TheMem); // 检查是否还有后续传输 rc = CallDSM(&m_sourceIdentity, DG_CONTROL, DAT_PENDINGXFERS, MSG_ENDXFER, (TW_MEMREF)&pendingXfers); } while (pendingXfers.Count != 0); // 所有传输结束 CallDSM(&m_sourceIdentity, DG_CONTROL, DAT_PENDINGXFERS, MSG_RESET, (TW_MEMREF)&pendingXfers); m_bTransferDone = true; break; } TranslateMessage(&msg); DispatchMessage(&msg); } // 禁用并关闭数据源 DisableAndCloseSource(); return images; }

这里有几个至关重要的细节：

传输模式：TWAIN支持Native（驱动提供句柄）、Memory（内存缓冲）和File（文件）三种传输模式。Memory模式最灵活，但需要自己管理内存。TW_IMAGEMEMXFER结构中的Memory.Flags设置为TWMF_APPOWNS | TWMF_POINTER，表示由应用分配内存。
数据块：图像数据是分块（Chunk）传输的，MSG_GET每次调用获取一块。TWRC_XFERDONE表示当前图片传输完毕。
Pending Transfers：DAT_PENDINGXFERS用于处理多页扫描。传输完一页后，调用MSG_ENDXFER，它会返回pendingXfers.Count，表示剩余待传输的页数。如果进纸器中还有纸且CAP_AUTOFEED为TRUE，这个计数可能大于0。
内存释放：务必在传输结束后释放分配的内存，并在会话结束时妥善关闭所有资源，否则可能导致内存泄漏或驱动状态异常。

4. 常见问题、排查技巧与兼容性实战

即使你严格遵循了API调用顺序，在实际项目中还是会遇到各种千奇百怪的问题。下面是我在多个项目中总结的一些典型问题及其解决方法。

4.1 驱动兼容性问题

问题表现：在某些扫描仪上设置成功，在另一些上失败；或者无UI模式在某些驱动上无效。

排查：不要假设所有驱动都支持所有能力。在设置任何能力前，先使用MSG_GET查询该能力的支持范围（TW_ARRAY或TW_ENUMERATION）。例如，设置分辨率前，先获取ICAP_XRESOLUTION的支持值列表，然后选择一个驱动支持的值进行设置，而不是硬编码一个值（如300）。
技巧：实现一个GetCapabilitySupport函数，用于记录和打印当前数据源的所有能力及其支持值。这在调试阶段非常有用。

问题表现：调用MSG_OPENDS或MSG_ENABLEDS后，驱动弹出错误对话框，阻塞线程。

排查：这通常是因为驱动内部出错。确保你的TW_IDENTITY结构体填写正确，特别是SupportedGroups字段。确保在调用MSG_ENABLEDS时，hParent是一个有效的、可用的窗口句柄。
技巧：尝试在另一个独立的、简单的测试程序中复现问题，以排除是你主程序复杂环境导致的问题。

4.2 图像传输与内存问题

问题表现：传输图像时崩溃，或获取的图像数据错乱。

排查：
1. 内存对齐：TW_IMAGEMEMXFER等结构体在传输前必须清零。分配的内存块指针必须确保对齐。虽然TWAIN标准没有严格要求，但一些驱动可能对内存对齐敏感。
2. 缓冲区大小：TW_SETUPMEMXFER.Preferred只是驱动建议的大小。你应该分配比这个值稍大的缓冲区（例如，Preferred + 4096）以应对某些驱动可能传输略大于建议值的数据块。
3. 数据类型转换：从TW_IMAGEINFO中解析出的图像宽度、高度、每像素位数等信息，用于计算图像数据总大小时，要注意整数溢出问题，特别是扫描大幅面高分辨率图像时。
技巧：在ProcessImageChunk函数中，不仅保存数据，还记录每个数据块的BytesWritten和Memory.Flags。有些驱动在最后一块数据时，BytesWritten可能小于缓冲区大小。

4.3 状态机与资源管理

问题表现：程序异常退出后，扫描仪被锁定，其他程序无法使用。

排查：这是典型的资源未正确释放。TWAIN状态机没有正确回到初始状态。

解决方案：实现严格的RAII（资源获取即初始化）包装类。确保在析构函数中，按照与初始化相反的顺序关闭所有资源：

~TwainScanner() { if (m_bSourceEnabled) { DisableSource(); } if (m_bSourceOpen) { CloseSource(); } if (m_bDSMLoaded) { CloseDSM(); } if (m_hTwainDLL) { FreeLibrary(m_hTwainDLL); } }

技巧：即使在DisableSource或CloseSource时遇到错误（返回TWRC_FAILURE），也最好继续执行后续的关闭步骤，尽可能多地清理资源。

4.4 多线程与消息循环

问题表现：在无UI模式的静默扫描中，程序“卡住”了，不响应。

排查：TWAIN驱动在内部可能仍然需要处理Windows消息。即使ShowUI为FALSE，你也必须提供一个有效的消息循环。如果你在后台线程中执行扫描操作，并且该线程没有消息泵（Message Pump），驱动可能会挂起。
解决方案：
1. 在主UI线程中执行TWAIN操作。
2. 如果必须在工作线程中执行，需要在该线程中创建一个隐藏窗口，并运行一个消息循环（PeekMessage/GetMessage+DispatchMessage）。
3. 使用MSG_PROCESSEVENT消息。这是TWAIN提供的一种机制，允许应用将事件传递给驱动处理。你可以在自己的消息循环中调用DSM_Entry(...,DG_CONTROL,DAT_EVENT,MSG_PROCESSEVENT, ...)来让驱动处理其内部事件。
心得：对于需要高稳定性的生产环境，我强烈推荐在主UI线程中处理TWAIN。将扫描操作封装成异步任务，通过窗口消息或事件对象通知UI线程进度和结果。

4.5 错误处理与日志

问题表现：出错时只有一个TWRC_FAILURE，不知道具体原因。

排查：TWAIN提供了DAT_STATUS来获取更详细的错误信息。在每次DSM_Entry调用返回TWRC_FAILURE后，立即调用DG_CONTROL,DAT_STATUS,MSG_GET来获取TW_STATUS结构，其中的ConditionCode字段（如TWCC_BUMMER、TWCC_CAPUNSUPPORTED）能提供更具体的错误原因。
技巧：实现一个完整的日志系统，记录每一次DSM_Entry调用的参数和返回值，以及获取到的TW_STATUS。这对于在客户现场调试无法复现的问题至关重要。可以将日志级别设为可配置，在开发时输出详细信息，上线后只记录错误。