MySQL不直接提供访问日志功能，需由应用层主动写入专用日志表，设计时应包含id、created_at、ip、user_id、path、method、status_code等必选字段，辅以异步写入、合理索引、分区归档等策略保障性能与可维护性。
MySQL 本身不直接提供类似 Web 服务器的“访问日志”（access log）功能，但可以通过应用层主动写入 + 合理的表结构设计，实现对用户操作、接口调用或关键查询的访问行为记录。核心思路是：由业务代码在关键路径中插入日志数据到专用日志表，而非依赖 MySQL 自带的 general_log（性能差、难过滤、不推荐生产使用）。
一、访问日志表设计要点
日志表需兼顾可读性、查询效率与存储成本，避免过度冗余，也别遗漏关键上下文：
- 必选字段：id（自增主键）、created_at（时间戳，建议 DATETIME(3) 或 TIMESTAMP(3) 支持毫秒）、ip（VARCHAR(45)，兼容 IPv6）、user_id（关联用户表，可为 NULL 表示匿名/系统调用）、path（如 "/api/order/create"，VARCHAR(255)）、method（如 "POST"，ENUM 或 VARCHAR(10)）、status_code（INT，如 200/404/500）
- 可选但实用字段：user_agent（TEXT，用于识别终端类型）、referer（VARCHAR(512)）、duration_ms（BIGINT，记录处理耗时，单位毫秒）、request_id（VARCHAR(64)，用于链路追踪）、params_summary（VARCHAR(512)，如 "?uid=123&limit=20" 的脱敏摘要）
- 注意避坑：不建议在日志表中存完整 request body 或 response body（体积大、敏感、影响性能）；如需审计原始数据，应单独落盘到文件或对象存储，并只在日志表中存文件路径或哈希值。
二、建表示例（MySQL 8.0+）
以下是一个轻量、可扩展的日志表结构：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
CREATE TABLE `access_log` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
`created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
`ip` VARCHAR(45) NOT NULL DEFAULT '',
`user_id` BIGINT UNSIGNED NULL COMMENT '登录用户ID，未登录则为NULL',
`path` VARCHAR(255) NOT NULL,
`method` ENUM('GET','POST','PUT','DELETE','PATCH') NOT NULL,
`status_code` SMALLINT NOT NULL DEFAULT 200,
`duration_ms` INT UNSIGNED NULL COMMENT '处理耗时（毫秒）',
`user_agent` VARCHAR(512) NULL,
`referer` VARCHAR(512) NULL,
`request_id` VARCHAR(64) NULL,
`params_summary` VARCHAR(512) NULL,
PRIMARY KEY (`id`),
INDEX `idx_created_at` (`created_at`) COMMENT '按时间范围查询最常用',
INDEX `idx_user_id` (`user_id`) COMMENT '查某用户行为',
INDEX `idx_path_method` (`path`, `method`) COMMENT '查某接口调用频次',
INDEX `idx_ip` (`ip`) COMMENT '查异常IP'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;三、应用层写入建议（以 Python Flask 为例）
不要在每个请求中同步执行 INSERT（会拖慢响应），推荐异步写入或批量落库：
- 使用消息队列（如 Redis List / Kafka）暂存日志，后台消费者持久化到 MySQL
- 若日志量不大（QPS < 100），可用连接池 + 异步线程（如 Python concurrent.futures.ThreadPoolExecutor）非阻塞插入
- 务必开启 MySQL 的 innodb_flush_log_at_trx_commit=2（平衡安全与性能），并关闭日志表的 autocommit，用事务批量提交（如每 50 条 commit 一次）
- 敏感字段（如手机号、token）必须脱敏后再写入，例如将 "138****1234" 替换原始值
四、查询与归档实践
日志表增长快，需配套运维策略：
- 日常分析用
SELECT COUNT(*) FROM access_log WHERE created_at > DATE_SUB(NOW(), INTERVAL 7 DAY)统计周调用量 - 按月分区（PARTITION BY RANGE COLUMNS(created_at)）提升大表查询效率（MySQL 8.0+ 支持）
- 冷数据定期归档：用
INSERT INTO archive_access_log SELECT * FROM access_log WHERE created_at < '2024-01-01'+DELETE，或导出为 CSV 存对象存储 - 禁止在日志表上加复杂 JOIN 或全文检索——这类需求应接入 ELK 或 ClickHouse
