出问题时给谁看什么,是两件事:访客需要一句能读懂的提示,维护者需要足够定位的记录。把这两者分开,既能保持页面体面,也能让排查有据可查。

01前台只显示必要信息

生产环境关闭错误直接输出,程序异常时返回统一的友好页面与合适状态码,不暴露文件路径、字段名与堆栈。表单校验失败也只说「哪一项需要怎么改」,不回显内部细节。这样既避免信息外泄,也不会让访客面对一片技术文字。

关于「错误与日志」,白名单比黑名单稳:允许什么写清楚,比穷举「不许什么」更少漏。

02日志记什么、不记什么

记录时间、请求地址、状态码与简要错误类型,足够定位问题即可。口令、令牌、完整请求体这类敏感值不写进日志;确需关联请求时,用可轮换的编号代替。错误日志定期清空或归档,避免无限增长占满空间。

「错误与日志」出错时,给访客的应该是一句可读的提示,而不是把路径、堆栈或字段名摊开。

03上线前与上线后各做一次

部署前先用语法检查把明显的错误挡在门外,再逐类页面走一遍状态码;上线后回看错误日志是否为空、是否出现新的告警。把「错误日志为零」列为验收项之一,比等到访客反馈再处理主动得多。

把「错误与日志」按最小权限配置:账号只开需要的库与操作,能少一分暴露就少一分。

要点速览

  • 生产环境关闭错误直显,异常返回统一友好页面。
  • 前台提示不暴露路径、字段名与堆栈。
  • 日志只记定位所需信息,不写口令与令牌。
  • 部署前语法检查,部署后核对错误日志。

把错误收在该出现的地方,页面和排查都会安静很多。

阅读提示本文涉及服务端处理与配置,示例只说明原理,不是可直接用于生产环境的完整程序。上线前请按实际运行版本核对,落实最小权限、参数绑定与输出转义,并保留回滚方案。