出问题时给谁看什么,是两件事:访客需要一句能读懂的提示,维护者需要足够定位的记录。把这两者分开,既能保持页面体面,也能让排查有据可查。
01前台只显示必要信息
生产环境关闭错误直接输出,程序异常时返回统一的友好页面与合适状态码,不暴露文件路径、字段名与堆栈。表单校验失败也只说「哪一项需要怎么改」,不回显内部细节。这样既避免信息外泄,也不会让访客面对一片技术文字。
关于「错误与日志」,白名单比黑名单稳:允许什么写清楚,比穷举「不许什么」更少漏。
02日志记什么、不记什么
记录时间、请求地址、状态码与简要错误类型,足够定位问题即可。口令、令牌、完整请求体这类敏感值不写进日志;确需关联请求时,用可轮换的编号代替。错误日志定期清空或归档,避免无限增长占满空间。
「错误与日志」出错时,给访客的应该是一句可读的提示,而不是把路径、堆栈或字段名摊开。
03上线前与上线后各做一次
部署前先用语法检查把明显的错误挡在门外,再逐类页面走一遍状态码;上线后回看错误日志是否为空、是否出现新的告警。把「错误日志为零」列为验收项之一,比等到访客反馈再处理主动得多。
把「错误与日志」按最小权限配置:账号只开需要的库与操作,能少一分暴露就少一分。
要点速览
- 生产环境关闭错误直显,异常返回统一友好页面。
- 前台提示不暴露路径、字段名与堆栈。
- 日志只记定位所需信息,不写口令与令牌。
- 部署前语法检查,部署后核对错误日志。
把错误收在该出现的地方,页面和排查都会安静很多。
