Vue 3 で axios の POST が思ったとおりに動かない — リロードされる・2回飛ぶ・GETになる

Vue 3 で axios の POST が思ったとおりに動かない — リロードされる・2回飛ぶ・GETになる

先に結論

「先に結論」の内容を図にまとめたもの

Vue で axios.post() を書いたのに思ったとおりに動かない、という話は3つに分かれます。 そして3つとも、原因は axios ではありません。 フォームの仕様と、HTTPのリダイレクトの仕様です。

表1:症状と原因
症状原因直すところ
POSTするとページがリロードされるフォームの既定動作が走っている@submit.prevent(詳しく)
POSTが2回飛ぶbutton の click と form の submit が両方発火どちらか一方にする(詳しく)
POSTしたのにGETで届く途中に301か302のリダイレクトがあるURLを直す。308/307にする(詳しく)

この3つは、同じ1行から出てきます。

<button @click="submit">送信</button>

<button> に type を書いていないことが、 症状1と症状2の両方の出どころです。手元のブラウザで確かめました。

表2:<button> の既定値(Chrome 152で実測)
書き方button.type の値form の submit
<button>(type なし)"submit"発火する
<button type="button">"button"発火しない

type を省略した <button> は、送信ボタンです。 ふつうのボタンのつもりで置くと、フォームの中では送信ボタンとして働きます。

プラグインを入れる時代は終わった

「プラグインを入れる時代は終わった」の内容を図にまとめたもの

vue-axios はもう要らない

検索すると vue-axios や vue-resource を入れる手順が出てきます。 Vue 3 の Composition API では、どちらも不要です。

これらは「this.$http で呼べるようにする」ための薄いラッパでした。 this を使わない書き方では、意味がありません。 import axios from 'axios' と書けば、それで終わりです。

表3:書き方の変遷
時代書き方いま
jQuery$.post(url, data)—
Vue 1〜2 初期vue-resource を入れて this.$http.post()公式の推奨から外れた
Vue 2vue-axios を入れて this.$http.post()Composition APIでは不要
Vue 3import axios して axios.post()これ
Vue 3(ライブラリなし)fetch()ブラウザ標準。追加なしで動く

axios と fetch のどちらを使うか

fetch はブラウザに入っているので、依存を増やしたくないなら fetch で足ります。 axios を選ぶ理由は、主に手間の差です。

表4:axios と fetch の違い
項目axiosfetch
インストール必要不要
JSONの送信オブジェクトを渡すだけJSON.stringify と Content-Type を自分で書く
JSONの受信res.data で取れるawait res.json() が要る
4xx・5xx のとき例外になる例外にならない。res.ok を自分で見る
共通設定(ベースURL・ヘッダ)インスタンスで持てる自分でラッパを書く
タイムアウトオプションで指定AbortSignal.timeout() を渡す

4行目が一番の違いです。 fetch は404でも500でも例外を投げないので、 res.ok を見ないまま res.json() を呼んで、HTMLのエラーページをパースして落ちます。 そのときの読み方は Unexpected token '<' ... is not valid JSON の原因と直し方 に書きました。

症状1:POSTするとページがリロードされる

「症状1:POSTするとページがリロードされる」の内容を図にまとめたもの

button に type を書いていない

axios.post() は走っているのに、直後にページが再読み込みされて結果が見えない、という症状です。 フォームの送信という既定動作が、別に走っています。

手元で確認したところ、submit ハンドラが呼ばれた時点で既定動作はまだ生きています。

表5:submitイベントの状態(実測)
確認したもの値意味
ハンドラ内の event.defaultPreventedfalse何もしなければフォームが送信される

つまり、ハンドラの中で axios.post() を呼んでも、それとは別にブラウザがフォームを送ります。 action を書いていなくても、現在のURLに送られます。これがリロードの正体です。

直し方

Vue公式が用意しているのが .prevent 修飾子です。公式の説明はこうです。

「.prevent 修飾子は、イベントが発火した際に、 デフォルトのブラウザの動作(例: フォームの送信によるページのリロード)を防ぐために用いる」
— イベントハンドリング(Vue.js 公式・要約)

<form @submit.prevent="submit">
  <input v-model="title">
  <button>送信</button>
</form>

@click ではなく @submit.prevent に付けるのがポイントです。 こうすると、Enterキーでの送信も、ボタンのクリックも、同じ1か所を通ります。

公式が挙げている修飾子は次のとおりです。

表6:イベント修飾子(Vue公式)
修飾子働きこの場面での使いどころ
.prevent既定動作を止めるフォーム送信には必須
.once一度だけ発火する二重送信の抑止に使える(後述)
.stop伝播を止める親のハンドラまで届かせたくないとき
.selfその要素自身でのみ動く子要素からの発火を無視したいとき
.captureキャプチャ段階で捕まえるこの場面では使わない
.passive既定動作を止めないと宣言する.prevent と同時に使わない

症状2:POSTが2回飛ぶ

「症状2:POSTが2回飛ぶ」の内容を図にまとめたもの

実際に数えてみた

<form> の中に <button @click="submit"> を置き、 フォーム側にも submit のハンドラがある場合、どちらが何回呼ばれるのかを数えました。

表7:ボタンを1回押したときの発火(Chrome 152で実測)
ボタンの書き方発火したイベント回数
<button>(type なし)button.click → form.submit2
<button type="button">button.click のみ1

順番も出ました。click が先で、submit が後です。 クリックが送信を引き起こしているので、この順になります。

ここで、@click と @submit の両方に POST を書いていると、2回飛びます。 ボタンは1回しか押していないのに、サーバーには2件登録されます。

これは画面上まったく見えません。 どちらの POST も成功するので、エラーも出ません。 データベースに同じレコードが2件ある、と気づいてから原因を探すことになります。 開発者ツールのNetworkタブで、1回の操作でリクエストが何本飛んでいるかを数えてください。

直し方

表8:二重送信を止める
やり方書き方評価
フォームに寄せる<form @submit.prevent="submit"> + <button>(ハンドラなし)推奨。Enterキーでも通る
ボタンに寄せる<button type="button" @click="submit">動くが、Enterキーで送信できない
両方に書く@submit.prevent + @click2回飛ぶ。やらない

それとは別に、ユーザーが連打したときの二重送信も止めておきます。 これは原因が違う(イベントではなく操作)ので、対処も別です。

<script setup>
import { ref } from 'vue';
import axios from 'axios';

const sending = ref(false);
const title = ref('');

async function submit() {
  if (sending.value) return;     // 連打を弾く
  sending.value = true;
  try {
    const res = await axios.post('/api/articles', { title: title.value });
    // 成功時の処理
  } finally {
    sending.value = false;       // 失敗しても必ず戻す
  }
}
</script>

<template>
  <form @submit.prevent="submit">
    <input v-model="title">
    <button :disabled="sending">
      {{ sending ? '送信中…' : '送信' }}
    </button>
  </form>
</template>

finally で戻すのが要点です。 try の中で戻すと、エラーのときにボタンが押せないままになります。

症状3:POSTしたのにGETで届く

「症状3:POSTしたのにGETで届く」の内容を図にまとめたもの

リダイレクトがメソッドを変える

axios.post() と書いているのに、サーバー側のログではGETになっている。 これはHTTPの仕様です。

MDNの記述を並べると、はっきりします。

表9:リダイレクトとメソッドの変化(MDN)
ステータスPOSTした場合MDNの記述(要約)
301 Moved PermanentlyGETに変わる「POSTリクエストに対して301を受け取った場合、続くリダイレクトリクエストではGETメソッドを使用します」
302 FoundGETに変わる「302をPOSTリクエストの返信として受け取った場合、以降のリダイレクトリクエストはGETメソッドを使用します」
307 Temporary RedirectPOSTのまま「元のリクエストのメソッドと本文は、リダイレクトされたリクエストを行う際に再利用されます」
308 Permanent RedirectPOSTのまま「リダイレクトされたリクエストでは、クライアントによってリクエストメソッドと本体が変更されることはありません」

MDNは対処も書いています。 301を使っていてメソッドを変えたくないなら308、302なら307に替えろ、という形です。

そしてGETに変わるとき、ボディも落ちます。 サーバー側では「GETで来たのにパラメータが無い」という見え方になります。

どこで起きているか

自分でリダイレクトを書いた覚えがなくても、サーバーやフレームワークが勝手に出しています。 よくある発生源はこれです。

表10:POSTが301/302を踏む典型
原因起きること直し方
URLの末尾スラッシュ/api/items → /api/items/ に301正しい方のURLを最初から書く
http から https へ常時SSL化の301https:// で書く
www のあり・なし正規化の301正規のホスト名で書く
未ログインでログイン画面へ302でログイン画面に飛ぶAPIは401をJSONで返す設計にする
フレームワークのルーティング別のパスへ302ルート定義を確認する

一番多いのは末尾スラッシュです。 GETでは気づきません。リダイレクトされても結果が同じだからです。 POSTにしたときだけ壊れます。

確認は、Networkタブでリクエストが何本あるかを見るのが早いです。 301や302が1本挟まっていれば、それが原因です。 curl -i で叩いてステータス行を見ても分かります。

APIの認証切れでログイン画面に302で飛ばす設計は、 POSTがGETに化けるうえに、HTMLが返ってきてJSONのパースで落ちます。 APIは401をJSONで返すほうが、どちらの問題も消えます。 このあたりは WordPress REST API の認証を通す にも書きました。

いまの最小構成

「いまの最小構成」の内容を図にまとめたもの

3つの症状を全部避けた形です。

<script setup>
import { ref } from 'vue';
import axios from 'axios';

const title = ref('');
const sending = ref(false);
const error = ref('');

async function submit() {
  if (sending.value) return;
  sending.value = true;
  error.value = '';
  try {
    const res = await axios.post(
      'https://example.com/api/articles',   // httpsで、末尾スラッシュも正しく
      { title: title.value },               // オブジェクトを渡すだけでJSONになる
      { timeout: 10000 }
    );
    title.value = '';
    console.log(res.data);
  } catch (e) {
    if (e.response) {
      error.value = `サーバーが ${e.response.status} を返しました`;
    } else if (e.request) {
      error.value = '応答がありません(通信かCORSの問題)';
    } else {
      error.value = `リクエストの組み立てに失敗: ${e.message}`;
    }
  } finally {
    sending.value = false;
  }
}
</script>

<template>
  <form @submit.prevent="submit">
    <input v-model="title" :disabled="sending">
    <button :disabled="sending">送信</button>
    <p v-if="error">{{ error }}</p>
  </form>
</template>

<button> に @click を書いていないこと、 @submit.prevent が付いていることを確認してください。これで症状1と2が消えます。

CSRFトークンを付ける

「CSRFトークンを付ける」の内容を図にまとめたもの

バックエンドのフレームワークがCSRF対策をしていると、トークンを付けないと403で弾かれます。 付ける場所は、いまはヘッダが標準的です。

表11:フレームワーク別のトークンの渡し方
フレームワークヘッダ名トークンの置き場所
LaravelX-CSRF-TOKEN<meta name="csrf-token">
RailsX-CSRF-Token<meta name="csrf-token">
DjangoX-CSRFTokencsrftoken クッキー
WordPress REST APIX-WP-Noncewp_localize_script で渡す
// 起動時に1回だけ、全リクエストに付ける
const token = document
  .querySelector('meta[name="csrf-token"]')
  ?.getAttribute('content');

if (token) {
  axios.defaults.headers.common['X-CSRF-TOKEN'] = token;
}

毎回の post() に書かないでください。 1か所に書き忘れただけで、そこだけ403になります。 axios.defaults か、インスタンスを作って interceptors で付けます。

トークンをリクエストのボディに入れる書き方は、いまは勧められません。 フレームワーク側がヘッダを見る前提になっていることが多く、 ボディに入れるとJSONの構造にトークンが混ざります。 ヘッダに入れてください。

エラーを切り分ける

「エラーを切り分ける」の内容を図にまとめたもの

axios のエラーは、3つのうちどれが入っているかで原因が分かれます。 公式ドキュメントがそう整理しています。

表12:axios のエラーの形(公式)
入っているもの意味疑うところ
error.responseサーバーが2xx以外で応答したステータスを見る。403ならCSRF、401なら認証、404ならURL
error.requestリクエストは送ったが応答が無いCORS・通信断・タイムアウト
どちらも無いリクエストの組み立てで失敗したURLやオプションの書き間違い

2行目がCORSです。 ブラウザがレスポンスを読ませてくれないので、axios から見ると「応答が無い」に見えます。 コンソールにCORSの警告が出ていないか確認してください。 サーバー側のログにリクエストが届いているなら、通信は成功していて、ブラウザが結果を捨てています。

なお、POSTでCORSが絡むと、本番のリクエストの前にOPTIONSが飛びます(プリフライト)。 Networkタブで同じURLにOPTIONSとPOSTが並んでいたら、それは二重送信ではありません。

AIに任せるときの注意

「AIに任せるときの注意」の内容を図にまとめたもの
表13:AIへの頼み方
頼むこと向くか理由
「Vue 3 の script setup で」と明示してフォーム送信を書かせる向く明示すれば vue-axios は出てこない
Networkタブのリクエスト一覧を貼って「2回飛ぶ原因は?」向く301が挟まっているか、POSTが2本かを読み分けられる
curl -i の出力を貼って「POSTがGETになる理由は?」向くステータス行を見るだけ
「Vue で ajax post する方法を教えて」向かないvue-axios や vue-resource が返る
「POSTできません、直して」(情報なし)向かない原因が3種類ある。表1で先に絞る
リクエストが何本飛んでいるかの確認向かないNetworkタブを自分で見る。ここは代われない

判定は簡単です。出てきたコードに this.$http か Vue.use( があれば古いと思ってください。 import axios from 'axios' で始まっていれば現代のものです。

よくある質問

POSTすると画面がリロードされます

フォームの既定動作が止まっていません。@submit.prevent を付けてください(詳しく)。 <button> は type を省略すると送信ボタンになります(表2)。

同じデータが2件登録されます

@click と @submit の両方にPOSTを書いていませんか。 ボタンを1回押すと click → submit の順で両方発火します(表7)。 どちらか一方に寄せてください。

axios.post なのにサーバーにGETで届きます

途中に301か302のリダイレクトがあります。 MDNは「POSTに対して301/302を受け取った場合、以降はGETを使う」と書いています(表9)。 一番多いのは末尾スラッシュです。

vue-axios は入れたほうがいいですか

Vue 3 の Composition API では不要です。 this.$http を生やすためのラッパなので、this を使わない書き方では意味がありません(表3)。

axios と fetch はどちらがいいですか

依存を増やしたくないなら fetch で足ります。 ただし fetch は4xx・5xxで例外を投げません(表4)。 res.ok を自分で見る必要があります。

error に response が入っていません

リクエストは送られたが応答が無い状態です(表12)。 CORS・通信断・タイムアウトを疑ってください。 サーバーのログに届いているなら、ブラウザが結果を捨てています。

同じURLにOPTIONSとPOSTが並んでいます

CORSのプリフライトです。二重送信ではありません。 POSTが2本ある場合だけが二重送信です。

403が返ります

CSRFトークンが付いていない可能性が高いです(表11)。 毎回のPOSTに書くのではなく、axios.defaults で一括して付けてください。

Enterキーで送信できません

<button type="button"> にしていませんか。 フォーム送信に寄せる書き方(@submit.prevent)にすると、Enterキーでも通ります(表8)。

まとめ

<button> の既定値とイベントの発火順は、 2026年10月25日に Chrome 152 で実際にイベントを数えて確認したものです。 リダイレクトの挙動はMDNの記載、修飾子はVue公式の記載によります。 ブラウザやフレームワークのバージョンで変わることがあります。 本番に出す前に、Networkタブでリクエストの本数とメソッドを自分で確認してください。