參數約束和建議

Apache RocketMQ 系統中有許多自訂參數和資源名稱。建議您根據以下說明設定系統，以避免因某些參數設定不當而導致應用程式例外。

參數	建議範圍	說明
主題名稱	建議字元：a~z A~Z 0~9 （）（-）（%） 建議長度：1~64 個字元 系統保留字元：主題名稱不允許使用以下保留字元或具有特殊字首的字元。 保留字元：TBW102 BenchmarkTest SELF_TEST_TOPIC OFFSET_MOVED_EVENT SCHEDULE_TOPIC_XXXX RMQ_SYS_TRANS_HALF_TOPIC RMQ_SYS_TRACE_TOPIC RMQ_SYS_TRANS_OP_HALF_TOPIC 保留字首字元： rmq_sys %RETRY% %DLQ% rocketmq-broker-	主題名稱應使用簡短、常見的字元，並避免使用特殊字元。特殊字元可能會導致系統剖析例外。如果字元太長，訊息可能會被拒絕。
消費者群組名稱	建議字元：a~z A~Z 0~9 （）（-）（%） 建議長度：1~64 個字元 系統保留字元：消費者群組名稱不允許使用以下保留字元或具有特殊字首的字元。 保留字元： DEFAULT_CONSUMER DEFAULT_PRODUCER TOOLS_CONSUMER FILTERSRV_CONSUMER __MONITOR_CONSUMER CLIENT_INNER_PRODUCER SELF_TEST_P_GROUP SELF_TEST_C_GROUP CID_ONS-HTTP-PROXY CID_ONSAPI_PERMISSION CID_ONSAPI_OWNER CID_ONSAPI_PULL CID_RMQ_SYS_TRANS 保留字元 * CID_RMQ_SYS * CID_HOUSEKEEPING	無
ACL 憑證	建議字元：AK（存取金鑰 ID）、SK（存取金鑰密碼）和 Token 僅支援 a~z A~Z 0~9 建議長度：小於 1024 個字元。	無
要求逾時	預設值：3000ms。	請求超時時長為客戶端本地同步調用的等待時間，請根據實際應用設定合適的值，避免線程長時間阻塞。
最大訊息大小	預設值：4 MB。不涉及訊息壓縮，僅計算訊息體大小。 取值範圍：建議小於 4 MB。	訊息傳輸應進行壓縮，控制負載，避免傳輸大檔案。
訊息自定義屬性	字元限制：所有可見字元。 建議長度：所有鍵值和長度小於 16KB。 系統保留屬性：以下保留屬性不允許作為自定義屬性的鍵。系統保留鍵	無
MessageGroup	字元限制：所有可見字元。 建議長度：1~64。	一般將 messageGroup 設定為需要保證順序的訊息標識符集合，例如訂單、使用者等。
訊息發送最大重試次數	預設值：3 次。 取值範圍：無限制。	發送重試策略對應用透明，建議設定較小的值，避免阻塞服務線程。若訊息在最大重試次數後仍發送失敗，建議服務端進行回查，保證訊息可靠性。
訊息消費最大重試次數	預設值：16 次。	消費重試次數根據實際服務需求設定合適的值，避免無限制的消費重試。重試次數過大會導致系統壓力增大。
事務異常檢查間隔	預設值：60 秒。	事務異常檢查間隔是指半事務訊息由於系統重啟或異常情況導致未提交，生產者客戶端會根據此間隔回查事務狀態。切勿將間隔設定過短，否則頻繁的回調呼叫會影響系統效能。
半事務訊息第一次回調時間	預設值：參照 [事務異常檢查間隔] * 最大檢查次數	無
半事務訊息最大超時時長	預設值：4 小時。	如果半事務訊息因系統重新啟動或異常狀況而未提交，生產者客戶端會根據事務例外檢查間隔檢查。如果在半事務訊息逾時期間後未傳回結果，半事務訊息將強制回滾。
PushConsumer sdk 快取	預設值： 最大快取數量：1024 最大快取大小：64 M。	快取訊息的數量和大小應設定為系統記憶體允許的限制。
PushConsumer 重試間隔	預設值： 同時傳遞類型：間隔時間階梯變更。 先進先出傳遞類型：3000 毫秒。	無
PushConsumer 使用執行緒	預設值：20	無
取得訊息批次大小	預設值：32	使用者一次從伺服器取得訊息的最大數量。建議您根據實際服務設定適當的參數值。如果一次取得的訊息數量過多，使用失敗時可能會重複大量訊息。
SimpleConsumer 最大隱藏時間	預設值：此參數為強制性，沒有預設值。 建議範圍：10 秒至 12 小時。	使用隱藏時間是指訊息處理和失敗後重試之間的總時間。建議您將值設定為比實際時間稍長。