ClickHouse集群静态存储致表只读错误的排查与解决求助

一、本地SSD存储挂载与权限校验 #

• 执行df -h确认VM上本地SSD的挂载状态，检查挂载点是否正常、剩余空间是否充足——静态存储只读标记的核心触发条件之一就是存储介质不可写或挂载异常。
• 执行ls -ld /path/to/clickhouse/storage验证ClickHouse进程对存储目录的读写权限，确保所属用户为clickhouse:clickhouse，权限至少为750。若权限异常，执行chown -R clickhouse:clickhouse /path/to/clickhouse/storage修复。

二、ClickHouse存储配置参数校验 #

• 检查config.xml或storage_configuration.xml中的存储配置：
  • 确认本地存储的type为local而非static（static类型是只读存储，会直接触发该错误），正确配置示例：

    <storage_configuration>
        <disks>
            <local_ssd>
                <type>local</type>
                <path>/mnt/local_ssd/clickhouse/</path>
            </local_ssd>
        </disks>
        <policies>
            <default>
                <volumes>
                    <default>
                        <disk>local_ssd</disk>
                    </default>
                </volumes>
            </default>
        </policies>
    </storage_configuration>
    

  • 执行DESCRIBE TABLE base_table查看storage_policy字段，确认表使用的存储策略指向正确的可写磁盘，而非静态存储策略。

三、物化视图与Kafka Engine表关联校验 #

• 执行SHOW CREATE TABLE kafka_table，检查Kafka Engine表是否被误设readonly = 1，若存在该配置会导致上游数据无法读取，间接引发物化视图写入失败。
• 执行ALTER TABLE base_table CHECK，确认base_table未被手动设置为只读；若返回只读错误，执行ALTER TABLE base_table REMOVE SETTING readonly解除只读状态。

四、集群一致性与Keeper校验 #

• 对比3台VM的storage_configuration.xml内容，确保所有节点的磁盘路径、存储策略定义完全一致，避免因节点配置不一致导致的只读标记同步异常。
• 执行SELECT * FROM system.disks查看所有节点的磁盘状态，确认is_read_only字段均为0；执行SELECT * FROM system.storage_policies查看存储策略的is_read_only状态，确保为0。

五、磁盘健康状态检查 #

• 在Google Cloud控制台查看本地SSD的健康状态，确认无磁盘损坏、IO错误告警。
• 执行dmesg | grep -i error检查系统层面的磁盘IO错误，若存在硬件存储异常，需更换本地SSD或重新挂载。

内容的提问来源于stack exchange，提问作者Anuraj Jain