【Spring Boot】application.properties の役割をやさしく解説

はじめに

Spring Boot のプロジェクトを開くと必ず存在する
application.properties。

「yml と何が違うの？」
「properties ってまだ使われているの？」
「どういうときに使うべきなの？」

そんな疑問を持つ方も多いと思います。

この記事では、application.properties の役割を
やさしく・実務で役立つ形 で整理していきます。

まずは実際の properties を見て、そこから少しずつ理解していきましょう。

まずはコードを確認

server.port=8081
spring.datasource.url=jdbc:mysql://localhost:3306/sample
spring.datasource.username=user
spring.datasource.password=pass

このように、
キーと値を「=」でつなぐ形式
それが application.properties です。

コードのしくみを解説

application.properties とは

一言でいうと、

Spring Boot の設定を「キー＝値」で書くためのファイル

です。

• ポート番号
• DB 接続情報
• ログ設定
• 独自の設定値

など、アプリの動作に関わる設定をここに書きます。

yml と properties の違い

項目	application.yml	application.properties
書き方	階層構造	キー＝値
読みやすさ	高い	シンプル
設定量が多い場合	見やすい	長くなりがち
配列	書きやすい	少し工夫が必要

どちらを使っても Spring Boot は同じように動きます。

よく使う設定を整理

サーバー設定

server.port=8081

DB 接続設定

spring.datasource.url=jdbc:mysql://localhost:3306/sample
spring.datasource.username=user
spring.datasource.password=pass

ログレベル

logging.level.root=INFO
logging.level.com.example.demo=DEBUG

プロファイル設定

spring.profiles.active=dev

application-dev.properties を読み込む設定です。

あわせて知っておきたいポイント

properties は「シンプルさ」が強み

• 1 行 1 設定
• インデント不要
• 階層構造をドットで表現

設定が少ない場合は properties のほうが読みやすいこともあります。

yml と properties は併用できる

Spring Boot は

• application.yml
• application.properties
  どちらも読み込みます。

ただし、同じキーがある場合は
properties → yml の順で上書き
されます。

プロファイルごとに分けられる

• application-dev.properties
• application-prod.properties

など、環境ごとに設定を分けるのが実務では一般的です。

使うときに気をつけたいこと

yml と properties を混在させすぎない

どちらかに統一したほうが、後から読む人が迷いません。

パスワードを直書きしない

本番環境では

• 環境変数
• Vault
• Parameter Store
  などを使うのが安全です。

長くなりすぎる場合は yml のほうが読みやすい

階層構造が深い設定は yml のほうが整理しやすいです。

まとめ

application.properties は、
Spring Boot の設定を「キー＝値」で書くためのファイル」
です。

• シンプルで読みやすい
• 小規模な設定に向いている
• yml と併用も可能
• プロファイルごとに分けられる

難しく聞こえますが、
「設定をシンプルに書くためのファイル」
と理解できれば十分です。

---