MySQL 配置參數(shù)全解之參數(shù)含義、作用域與運維建議(完整配置文件)

更新時間：2026年01月24日 10:30:19 作者：霖霖總總

MySQL配置文件參數(shù)解析表涵蓋了多個配置段,如[client]、[mysql]、[mysqld]和[mysqld_safe],詳細(xì)解釋了每個參數(shù)的含義、當(dāng)前值、默認(rèn)值以及一些關(guān)鍵參數(shù)的作用和優(yōu)化建議,感興趣的朋友跟隨小編一起看看吧

一、MySQL 配置文件參數(shù)解析表

配置段	參數(shù)名	含義說明	當(dāng)前值	默認(rèn)值
[client]	loose-default-character-set	客戶端連接默認(rèn)字符集；`loose-` 前綴表示若當(dāng)前 MySQL 版本不支持該參數(shù)則忽略而不報錯。	utf8mb4	無（繼承系統(tǒng) locale）
[mysql]	no-auto-rehash	禁用命令行 Tab 自動補全（如表名、列名），避免連接時拉取全量元數(shù)據(jù)，加快啟動速度。	（啟用）	OFF（即 auto-rehash 默認(rèn)開啟; use --skip-auto-rehash to disable）
[mysql]	prompt	自定義 MySQL 命令行提示符格式：`\u`=用戶，`\h`=主機，`\d`=數(shù)據(jù)庫，`\r:\m:\s`=時:分:秒。	\u@\h:\d\r:\m:\s>	mysql>
[mysql]	max_allowed_packet	客戶端與服務(wù)器間單個數(shù)據(jù)包最大大小，影響大結(jié)果集或 BLOB 傳輸。	64M	64M
[mysqld]	user	啟動 mysqld 進(jìn)程的操作系統(tǒng)用戶，必須對 datadir 有讀寫權(quán)限。	mysql	mysql（Linux 包安裝）
[mysqld]	port	MySQL 監(jiān)聽的 TCP 端口。	3306	3306
[mysqld]	socket	本地 Unix 域套接字路徑，用于本地高效連接。	/var/lib/mysql/mysql.sock	/tmp/mysql.sock（源碼編譯）或 /var/run/mysqld/mysqld.sock（Debian）
[mysqld]	bind-address	監(jiān)聽的網(wǎng)絡(luò)接口 IP；`0.0.0.0` 表示監(jiān)聽所有 IPv4 接口。	0.0.0.0	*（所有地址）
[mysqld]	event_scheduler	啟用事件調(diào)度器，可定期執(zhí)行 SQL 任務(wù)（類似 cron）。	ON	OFF
[mysqld]	basedir	MySQL 安裝根目錄。	/usr	依賴安裝方式
[mysqld]	datadir	數(shù)據(jù)庫數(shù)據(jù)文件存儲目錄。	/var/lib/mysql	/usr/local/mysql/data（源碼）或 /var/lib/mysql（包管理）
[mysqld]	tmpdir	臨時文件（如排序、臨時表）存儲目錄。	/tmp	/tmp
[mysqld]	log_error	錯誤日志文件路徑。	/var/log/mysql/error.log	stderr 或 syslog（未指定時）
[mysqld]	pid-file	記錄 MySQL 主進(jìn)程 ID 的文件路徑。	/var/run/mysqld/mysqld.pid	$ {DATADIR}/host_name.pid
[mysqld]	max_connections	允許的最大并發(fā)連接數(shù)。	512	151
[mysqld]	max_connect_errors	同一主機連接失敗超此后被屏蔽，需 `FLUSH HOSTS` 解除。	100000	100
[mysqld]	back_log	操作系統(tǒng)在 MySQL 處理前可排隊的連接請求數(shù)（TCP listen backlog）。	512	50 + (max_connections / 5)，上限 900
[mysqld]	wait_timeout	非交互連接空閑超時時間（秒），超時后斷開。	28800	28800
[mysqld]	interactive_timeout	交互式連接（如 CLI）空閑超時時間（秒）。	1800	28800
[mysqld]	key_buffer_size	MyISAM 引擎索引緩存大??；即使不用 MyISAM 也建議保留少量。	32M	8M
[mysqld]	sort_buffer_size	每個連接用于 `ORDER BY` 或 `GROUP BY` 的排序內(nèi)存，按需分配。	4M	256K
[mysqld]	join_buffer_size	用于無索引 JOIN 的連接緩沖區(qū)大小，每個 JOIN 分配一份。	4M	256K
[mysqld]	read_buffer_size	順序掃描（如全表掃描）時的緩沖區(qū)大小。	1M	128K
[mysqld]	read_rnd_buffer_size	隨機讀?。ㄈ绨磁判蚪Y(jié)果回表）的緩沖區(qū)大小。	2M	256K
[mysqld]	max_allowed_packet	服務(wù)器允許的最大數(shù)據(jù)包大小，需 ≥ 客戶端設(shè)置。	64M	64M
[mysqld]	thread_cache_size	線程緩存大小，緩存已斷開連接的線程以加速新連接復(fù)用。	64	-1（自動）或 0（舊版本）
[mysqld]	table_open_cache	表描述符緩存數(shù)量，影響同時打開表的能力。	4096	4000（8.0+），2000（5.7）
[mysqld]	table_definition_cache	表定義（.frm 等元數(shù)據(jù)）緩存數(shù)量，減少磁盤 IO。	4096	2000（或自動計算）
[mysqld]	open_files_limit	操作系統(tǒng)允許 MySQL 打開的最大文件數(shù)（需系統(tǒng) ulimit 支持）。	65535	min(5000, ulimit -n)
[mysqld]	character-set-server	服務(wù)端默認(rèn)字符集。	utf8mb4	utf8mb4
[mysqld]	collation-server	服務(wù)端默認(rèn)排序規(guī)則。	utf8mb4_unicode_ci	utf8mb4_0900_ai_ci（8.0）
[mysqld]	log_error_verbosity	錯誤日志詳細(xì)級別（1=error, 2=+warning, 3=+note）。	2	3（8.0+），2（5.7）
[mysqld]	slow_query_log	開啟慢查詢?nèi)罩尽?/td>	ON	OFF
[mysqld]	slow_query_log_file	慢查詢?nèi)罩疚募窂健?/td>	/var/log/mysql/mysql-slow.log	host_name-slow.log
[mysqld]	long_query_time	SQL 執(zhí)行時間超過此值（秒）記為慢查詢。	1	10.0
[mysqld]	log_queries_not_using_indexes	是否記錄未使用索引的查詢到慢日志。	OFF	OFF
[mysqld]	general_log	是否開啟通用查詢?nèi)罩荆ㄓ涗浰?SQL）。	OFF	OFF
[mysqld]	general_log_file	通用查詢?nèi)罩疚募窂健?/td>	/var/log/mysql/mysql-general.log	host_name.log
[mysqld]	server-id	實例唯一標(biāo)識，主從復(fù)制必需，集群內(nèi)必須唯一。	1	0（禁用復(fù)制）
[mysqld]	log_bin	啟用二進(jìn)制日志并指定路徑前綴。	/var/log/mysql/mysql-bin.log	OFF（未設(shè)置）
[mysqld]	binlog_format	二進(jìn)制日志格式，ROW 模式最安全，推薦用于復(fù)制。	ROW	ROW（8.0+），STATEMENT（5.7）
[mysqld]	expire_logs_days	自動刪除超過 N 天的 binlog（?? 8.0.35+ 已廢棄）。	14	0（不自動清理）
[mysqld]	max_binlog_size	單個 binlog 文件最大大小，達(dá)到后輪轉(zhuǎn)新文件。	1G	1G
[mysqld]	sync_binlog	每 N 次事務(wù)提交同步 binlog 到磁盤；1=每次提交都刷盤（最安全）。	1	1（8.0+），0（5.7）
[mysqld]	binlog_cache_size	每個連接事務(wù)中 binlog 的內(nèi)存緩存大小。	128K	32K
[mysqld]	binlog_rows_query_log_events	ROW 格式下是否在 binlog 中記錄原始 SQL（用于調(diào)試）。	OFF	OFF
[mysqld]	innodb_buffer_pool_size	InnoDB 緩沖池大小，緩存數(shù)據(jù)和索引，是最重要的性能參數(shù)。	2G	128M
[mysqld]	innodb_buffer_pool_instances	將緩沖池劃分為多個實例，減少內(nèi)部爭用；建議每 1GB 緩沖池設(shè) 1 個實例。	2	1（<1GB 時），8（≥1GB 且 ≥8.0.29）
[mysqld]	innodb_max_dirty_pages_pct	臟頁占緩沖池比例超過此值時，后臺線程加速刷新。	75	90
[mysqld]	default_storage_engine	默認(rèn)存儲引擎。	InnoDB	InnoDB
[mysqld]	innodb_file_per_table	每張表使用獨立 .ibd 文件，便于管理與空間回收。	ON	ON
[mysqld]	innodb_flush_method	InnoDB 數(shù)據(jù)文件 I/O 方式，O_DIRECT 繞過 OS 緩存，避免雙緩沖。	O_DIRECT	fsync（Linux）
[mysqld]	innodb_flush_log_at_trx_commit	事務(wù)提交時 redo log 刷盤策略；1=最安全（ACID），0/2=更高性能但可能丟數(shù)據(jù)。	1	1
[mysqld]	innodb_data_file_path	InnoDB 系統(tǒng)表空間初始大小及自動擴展策略。	ibdata1:64M:autoextend	ibdata1:12M:autoextend
[mysqld]	innodb_log_file_size	單個 redo log 文件大小。	2G	48M（8.0.30 前），96M（8.0.30+）
[mysqld]	innodb_log_files_in_group	redo log 文件數(shù)量（通常為 2）。	2	2
[mysqld]	innodb_log_buffer_size	redo log 內(nèi)存緩沖區(qū)大小，大事務(wù)可適當(dāng)增大。	16M	16M
[mysqld]	innodb_lock_wait_timeout	InnoDB 行鎖等待超時時間（秒），超時后報錯。	50	50
[mysqld]	innodb_io_capacity	后臺任務(wù)（刷臟頁等）的 I/O 能力基準(zhǔn)值。	200	200
[mysqld]	innodb_io_capacity_max	后臺任務(wù)突發(fā) I/O 上限。	2000	2000
[mysqld]	innodb_buffer_pool_dump_at_shutdown	關(guān)閉時將熱數(shù)據(jù)頁列表 dump 到磁盤，加速下次啟動預(yù)熱。	ON	ON
[mysqld]	innodb_buffer_pool_load_at_startup	啟動時加載之前 dump 的熱數(shù)據(jù)頁列表。	ON	ON
[mysqld]	innodb_print_all_deadlocks	將所有死鎖信息記錄到錯誤日志，便于分析。	ON	OFF
[mysqld]	default_authentication_plugin	新建用戶的默認(rèn)認(rèn)證插件，兼容舊客戶端。	mysql_native_password	caching_sha2_password（8.0+）
[mysqld]	performance_schema	啟用性能模式，用于監(jiān)控內(nèi)部運行狀態(tài)。	ON	ON
[mysqld]	performance_schema_max_table_instances	限制 performance_schema 中表實例數(shù)量，控制內(nèi)存使用。	5000	-1（自動）
[mysqld]	gtid_mode	啟用 GTID（全局事務(wù) ID）。	ON	OFF
[mysqld]	enforce_gtid_consistency	強制 GTID 安全語句（禁止非事務(wù)性操作）。	ON	OFF
[mysqld]	log_slave_updates	從庫是否將 relay log 寫入自己的 binlog（級聯(lián)復(fù)制必需）。	1	OFF
[mysqld]	read_only	是否只讀模式；從庫應(yīng)設(shè)為 1。	0	OFF
[mysqld]	relay-log	從庫 relay log 文件路徑前綴。	/var/log/mysql/slave-relay-bin	host_name-relay-bin
[mysqld]	relay-log-index	relay log 索引文件路徑	/var/log/mysql/slave-relay-bin.index	host_name-relay-bin.index
[mysqld]	master_info_repository	主庫連接信息存儲方式（TABLE 表示存入 mysql.slave_master_info 表）。	TABLE	FILE（5.7），TABLE（8.0+）
[mysqld]	relay_log_info_repository	relay log 位置信息存儲方式（TABLE 表示存入 mysql.slave_relay_log_info 表）。	TABLE	FILE（5.7），TABLE（8.0+）
[mysqld]	relay_log_recovery	啟動時自動恢復(fù) relay log，避免數(shù)據(jù)不一致。	ON	OFF
[mysqld]	slave_parallel_type	并行復(fù)制分組策略，LOGICAL_CLOCK 基于事務(wù) commit_parent 并行。	LOGICAL_CLOCK	DATABASE（5.7），LOGICAL_CLOCK（8.0+）
[mysqld]	slave_parallel_workers	從庫并行應(yīng)用 relay log 的工作線程數(shù)。	8	0（串行）
[mysqld_safe]	log-error	mysqld_safe 啟動腳本使用的錯誤日志路徑。	/var/log/mysql/error.log	同 mysqld
[mysqld_safe]	socket	mysqld_safe 使用的 socket 路徑。	/var/lib/mysql/mysql.sock	同 mysqld
[mysqld_safe]	open-files-limit	通過 mysqld_safe 啟動時設(shè)置的系統(tǒng) open files 限制。	65535	無（繼承 shell）
[mysqldump]	quick	逐行檢索結(jié)果而非緩存到內(nèi)存，避免大表導(dǎo)出 OOM。	（啟用）	ON
[mysqldump]	max_allowed_packet	mysqldump 客戶端允許的最大包大小。	256M	24M
[mysqldump]	single-transaction	對 InnoDB 表使用一致性快照導(dǎo)出（不加鎖），推薦用于備份。	TRUE	OFF
[mysqladmin]	character-set-client	mysqladmin 工具連接時的客戶端字符集。	utf8mb4	無

特別說明

1.loose前綴的作用是允許配置文件中包含對當(dāng)前 MySQL 版本不可用的參數(shù)時,MySQL 會忽略這些帶有loose前綴的未知參數(shù)，而不會導(dǎo)致服務(wù)器啟動失敗
2.server-id的值在配置文件中不能使用變量，需要在實際使用手動修改或者配合腳本進(jìn)行變更
3. expire_logs_days 廢棄警告：
若使用 MySQL ≥8.0.35，應(yīng)替換為：

binlog_expire_logs_seconds = 1209600  # 14 * 24 * 3600

binlog_expire_logs_seconds參數(shù)是在MySQL8.0中新增的參數(shù)
binlog_expire_logs_seconds參數(shù)和expire_logs_days 參數(shù)是互相排斥的，在MySQL服務(wù)器中只能選擇其中一個參數(shù)使用
4.no-auto-rehash參數(shù)解析

啟用--auto-rehash的問題：
對于大型數(shù)據(jù)庫實例（成千上萬張表），客戶端連接后會執(zhí)行大量 SHOW DATABASES、SHOW TABLES、DESCRIBE table 等查詢，耗時數(shù)秒甚至數(shù)十秒

在命令行臨時啟用： 臨時想用 Tab 補全命令

mysql --auto-rehash -u user -p

--auto-rehash參數(shù)的主要功能就是自動補全

使用no-auto-rehash的好處：
連接瞬間完成，無額外查詢，體驗更流暢，可以避免無意義的元數(shù)據(jù)拉取，提升效率

5.配置文件 [mysql] 段設(shè)置的參數(shù)，只影響使用 mysql 命令行工具的行為，無法用 SHOW VARIABLES LIKE ‘xxx’ 命令查到
因為這些參數(shù)是客戶端選項，不是服務(wù)端系統(tǒng)變量

二、完整版配置文件

[client]
# CLIENT SETTINGS - Applied to all client programs
loose-default-character-set = utf8mb4 # Default character set for clients
[mysql]
# MYSQL CLIENT SPECIFIC SETTINGS
no-auto-rehash # Disable automatic tab completion for faster connection
prompt = "\\u@\\h : \\d \\r:\\m:\\s> " # Custom prompt format
(user@host:database time)
max_allowed_packet = 64M
#Define the maximum number of bytes for a single data packet transfer between the
MySQL server and the client
[mysqld]
# CORE SERVER SETTINGS
user = mysql
port = 3306
socket = /var/lib/mysql/mysql.sock
bind-address = 0.0.0.0 # IP address to bind to (use internal IP in production)
event_scheduler = ON # Enable the event scheduler
# DIRECTORIES
basedir = /usr
datadir = /var/lib/mysql
tmpdir = /tmp
log_error = /var/log/mysql/error.log
pid-file = /var/run/mysqld/mysqld.pid
# CONNECTIONS
max_connections = 512 # Maximum number of simultaneous connections
max_connect_errors = 100000 # Maximum connection errors before host blocking
back_log = 512 # Connection backlog queue size
wait_timeout = 600 # Timeout for non-interactive connections (seconds)
interactive_timeout = 1800 # Timeout for interactive connections (seconds)
wait_timeout = 28800
# MEMORY & CACHE (ADJUST BASED ON YOUR RAM!)
# -- Global Cache --
key_buffer_size = 32M # Key buffer size for MyISAM (recommended even if not
using MyISAM)
# -- Per-Connection Memory --
sort_buffer_size = 4M # Buffer size for ORDER BY and GROUP BY operations
join_buffer_size = 4M # Buffer size for joins without indexes
read_buffer_size = 1M # Buffer size for sequential table scans
read_rnd_buffer_size = 2M # Buffer size for random-read buffer
max_allowed_packet = 64M # Maximum packet size
thread_cache_size = 64 # Thread cache size for faster connection handling
# TABLE DEFINITION
table_open_cache = 4096 # Number of open tables cache
table_definition_cache = 4096 # Number of table definition cache
open_files_limit = 65535 # Maximum number of open files
# CHARACTER SET & COLLATION
character-set-server = utf8mb4 # Default server character set
collation-server = utf8mb4_unicode_ci # Default server collation
# LOGGING
# Error Log
log_error = /var/log/mysql/error.log
log_error_verbosity = 2 # Error log verbosity level
# Slow Query Log
slow_query_log = ON # Enable slow query log
slow_query_log_file = /var/log/mysql/mysql-slow.log
long_query_time = 1 # Threshold for slow queries (seconds)
log_queries_not_using_indexes = OFF # Don't log queries not using indexes
# General Query Log (usually disabled in production)
general_log = OFF
general_log_file = /var/log/mysql/mysql-general.log
# BINARY LOGGING (For Replication & Point-in-Time Recovery)
server-id = 1 # Unique server ID for replication
log_bin = /var/log/mysql/mysql-bin.log # Binary log path
binlog_format = ROW # Binary log format (ROW recommended)
expire_logs_days = 14 # Binary log expiration period (days)
max_binlog_size = 1G # Maximum binary log file size
sync_binlog = 1 # Sync binary log to disk (1=safest)
binlog_cache_size = 128K # Binary log cache size
binlog_rows_query_log_events = OFF # Log original SQL in ROW format (for
debugging)
# -- InnoDB Buffer Pool --
innodb_buffer_pool_size = 2G # Most important cache (50-80% of system RAM)
innodb_buffer_pool_instances = 2 # Number of buffer pool instances (1 per GB
recommended)
innodb_max_dirty_pages_pct = 75 #Control the threshold for refreshing dirty
pages
# FILE FORMAT
default_storage_engine = InnoDB # Default storage engine
innodb_file_per_table = ON # Use separate tablespace for each InnoDB table
innodb_flush_method = O_DIRECT # InnoDB flush method (direct I/O)
innodb_flush_log_at_trx_commit = 1 # Flush log to disk on transaction commit
(1=safest)
# INNODB SPECIFIC
innodb_data_file_path = ibdata1:64M:autoextend # InnoDB system tablespace
configuration
innodb_log_file_size = 2G # InnoDB redo log file size (recommended 1-2G)
innodb_log_files_in_group = 2 # Number of InnoDB redo log files
innodb_log_buffer_size = 16M # InnoDB log buffer size
innodb_lock_wait_timeout = 50 # InnoDB lock wait timeout (seconds)
innodb_io_capacity = 200 # InnoDB I/O capacity (adjust based on storage
performance)
innodb_io_capacity_max = 2000 # Maximum InnoDB I/O capacity
innodb_buffer_pool_dump_at_shutdown = ON # Dump buffer pool at shutdown
innodb_buffer_pool_load_at_startup = ON # Load buffer pool at startup
innodb_print_all_deadlocks = ON # Log all deadlocks to error log
# MYSQL 8.0 AUTHENTICATION PLUGIN SETTINGS
default_authentication_plugin = mysql_native_password # Maintain compatibility
with older clients
# PERFORMANCE SCHEMA (Adjust based on monitoring needs)
performance_schema = ON # Enable performance schema
performance_schema_max_table_instances = 5000 # Limit performance schema memory
usage
#GTID
gtid_mode=ON
enforce_gtid_consistency=ON
# Slave Variables
log_slave_updates =1 #Control whether the slave library writes the received
changes of the master library to its own binary log
read_only = 0
relay-log = /var/log/mysql/slave-relay-bin
relay-log-index = /var/log/mysqlslave-relay-bin.index
master_info_repository=TABLE # Control the storage method of replication status
information
relay_log_info_repository=TABLE #Control the storage method of replication status
information
relay_log_recovery=ON # Trigger the automatic recovery process
slave_parallel_type=LOGICAL_CLOCK #Define the transaction grouping policy for
parallel replication
slave_parallel_workers=8 # Set the number of parallel execution threads
[mysqld_safe]
# MYSQL SAFE STARTUP SETTINGS
log-error = /var/log/mysql/error.log
socket = /var/lib/mysql/mysql.sock
open-files-limit = 65535
[mysqldump]
# MYSQLDUMP SETTINGS
quick
max_allowed_packet = 256M
single-transaction = TRUE # Recommended for InnoDB backups
[mysqladmin]
# MYSQLADMIN SETTINGS
character-set-client = utf8mb4

到此這篇關(guān)于MySQL 配置參數(shù)全解之參數(shù)含義、作用域與運維建議(完整配置文件)的文章就介紹到這了,更多相關(guān)mysql配置參數(shù)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: